Imagine Communications Motion4 Server Nexio Motion Server Installation Reference

PDF

Dokument

Reklamë

Installation Reference

Nexio Motion4 Server v4.12

4/12/2017

Revision: Release

Nexio Motion4 Server v4.12 Installation Reference

Publication Information

Proprietary and Confidential.

Imagine Communications considers this document and its contents to be proprietary and confidential.

Except for making a reasonable number of copies for your own internal use, you may not reproduce this publication, or any part thereof, in any form, by any method, for any purpose, or in any language other than English without the written consent of Imagine Communications. All other uses are illegal.

This publication is designed to assist in the use of the product as it exists on the date of publication of this manual, and may not reflect the product at the current time or an unknown time in the future. This publication does not in any way warrant description accuracy or guarantee the use for the product to which it refers. Imagine Communications reserves the right, without notice to make such changes in equipment, design, specifications, components, or documentation as progress may warrant to improve the performance of the product.

Trademarks

Product names and other appropriate trademarks, e.g. D-Series™, Invenio®, PowerSmart®, Versio™ are trademarks or trade names of Imagine Communications or its subsidiaries.

Microsoft® and Windows® are registered trademarks of Microsoft Corporation. All other trademarks and trade names are the property of their respective companies.

Contact Information

Imagine Communications has office locations around the world. For domestic and international location and contact information, visit our Contact page

(http://www.imaginecommunications.com/how-buy/contact-us).

Support Contact Information

For domestic and international support contact information see:



Support Contacts (http://www.imaginecommunications.com/how-buy/contact-us)



Worldwide Support e-mail (mailto: [email protected])



Customer Community Portal (http://app.imaginecommunications.com/customercommunity)



Warranty & Contract Information

(http://www.imaginecommunications.com/services/customer-care)



MyImagine Academy Training (http://www.imaginecommunications-academy.com)



Product Manuals (http://www.imaginecommunications.com/services/product-manuals)

Nexio Motion4 Server

Installation Reference Contents

Overview................................................................................................................ 5

About this Document ............................................................................................................................... 5

Application and Database Servers ........................................................................................................ 5

Quick Install Reference ............................................................................................................................. 5

Database Server ................................................................................................................................... 5

Motion Server ....................................................................................................................................... 5

Database Server ..................................................................................................... 6

Requirements ........................................................................................................................................... 6

Database Server Installation ..................................................................................................................... 6

Installing SQL Server 2012/2014/2016 ................................................................................................. 6

Modify Windows Firewall Advance Settings ...................................................................................... 14

Motion Server ...................................................................................................... 19

Requirements ......................................................................................................................................... 19

Before You Begin .................................................................................................................................... 19

Uninstall Previous Versions ................................................................................................................ 19

Create Domain Accounts .................................................................................................................... 19

Installation Rules, Locations, etc. ....................................................................................................... 20

Installing Nexio Motion Server ............................................................................................................... 20

Installed Prerequisites ........................................................................................................................ 20

Installing Nexio Motion Server Components ..................................................................................... 21

Create the Nexio Motion database ........................................................................................................ 24

About Database Keys and Description Column .................................................................................. 25

About the DB Cleanup Service ........................................................................................................... 26

Configuring REST API .............................................................................................................................. 26

Configure the Server ............................................................................................................................... 28

Registering Motion and Starting Services .............................................................................................. 29

(Option) Manually Starting a Service ................................................................................................. 30

Upgrading Motion4 Server and Client .................................................................. 31

Motion 4.7 Upgrade Note ...................................................................................................................... 31

Workflows .......................................................................................................................................... 31

Nexio Motion4 Server

Installation Reference Contents

FTP Endpoints ..................................................................................................................................... 31

System Backup Dialog Box: configuration export .............................................................................. 31

Preparing for the upgrade ...................................................................................................................... 31

To upgrade Motion 4 Server and Client ................................................................................................. 32

Motion4 Licensing with Software Dongle............................................................. 34

About the Dongle ................................................................................................................................... 34

Licensing Checks ..................................................................................................................................... 34

Overall Application License ................................................................................................................ 34

User information ................................................................................................................................ 34

Licensing Process .................................................................................................................................... 35

Troubleshooting ................................................................................................... 36

Contacting Support ................................................................................................................................. 36

Appendix .............................................................................................................. 37

Baton DC Configuration Notes ............................................................................................................... 37

Operation ........................................................................................................................................... 37

Deployment ........................................................................................................................................ 37

Configuration notes: ........................................................................................................................... 37

Logging .................................................................................................................................................... 38

Magellan Diagnostic Logging .............................................................................................................. 38

Process Explorer: Diagnostic Logging Default Settings ...................................................................... 38

Nexio Motion4 Server

Installation Reference

Overview

About this Document

This Installation Guide describes how to install and configure Nexio® Motion Server. This process applies to all versions of Nexio Motion Server, unless otherwise documented.

Application and Database Servers

This guide is based on an environment that has Motion Server set up across two servers: a database server and a single Motion Server with all components installed.

Alternatively, Motion Server can be set up across four servers: three application servers (Server API,

Core Services, and Device Manager Service) and a database server. If Nexio Motion is installed across multiple servers, apply the appropriate installation steps to the server that has multiple Nexio Motion components installed:



Server API Server: Install Wcf, Rest, and Database components.



Core Services Server: Install Core Services.



Device Manager Server: Install Device Manager Service.

Quick Install Reference

The new procedure is as followed:

Database Server

Motion Server

1. Create a user (local or domain) that will be used by the services. For details see Create Domain

Accounts (on page 19).

2. Run the Motion Server MSI and provide the user from #1 info. If not on a domain, the field can be

left empty. For details see Installing Nexio Motion Server Components (on page 21).

3. All the roles and dependencies are installed. This can take more than 10mn. This installs everything

(IIS, Magellan, HsMediaFile, etc.). For details see Installed Prerequisites (on page 20).

4. At the end of the installation, do not restart.

5. Run the DB tool. For details see Create the Nexio Motion database (on page 24).

6. Run the REST API Tool. For details see Configuring REST API (on page 26).

7. Run the server tool. For details see Configure the Server (on page 28).

Nexio Motion4 Server

Installation Reference Database Server

8. Register Motion. For details see Registering Motion and Starting Services (on page 29) and Motion4

Licensing with Software Dongle.

9. Restart the computer.

10. After the computer restarted it’ll take up to a couple of minutes for the services to start.

11. Check that all the Motion services started. For details see Registering Motion and Starting Services

(on page 29).



Should any of the services fail to start (i.e. the Workflow manager service might fail to start the first time), they can be manually started.



If some services cannot start, check the logs in Magellan Diagnostic Logging to troubleshoot.

Contact Imagine Communications Technical Support for assistance.

Database Server

Requirements

The following requirements must be met for the Database Server.



Operating System:



Windows® Server 2012 or later



(Included in the OS Install) Microsoft® .NET Framework 4.6 with latest Service Pack

Software:



Microsoft® SQL Server® 2012/2014/2016

Note: While not a tested configuration of Motion 4, Microsoft’s website states it supports installing SQL

2012 on Windows Server 2008 R2 SP1 Standard 64-bit and Windows Server 2008 SP2 Standard 64-bit. https://msdn.microsoft.com/en-us/library/ms143506(v=sql.120).aspx.

Database Server Installation

The following pre-installation steps must be completed on the database server prior to installing Nexio

Motion Server software.

Log on to the database server using the [domain]\Administrator account details.

Installing SQL Server 2012/2014/2016

Use this procedure to install SQL Server 2012/2014/2016.

Nexio Motion4 Server

Installation Reference

1. Install SQL Server by starting the SQL Server Installation Wizard. Click OK.

Database Server

2. Enter the product key and click Next.

3. Accept the license terms and click Next.

4. Click Install to start installing the setup support files.

Nexio Motion4 Server

Installation Reference Database Server

5. Verify that all setup rules have been passed. Note that the Windows Firewall rule generates a warning since firewall is enabled on the server. Click Next.

6. Select SQL Server Feature Installation and click Next.

7. Select the following features: Database Engine Services, and Management Tools – Basic /

Management Tools – Complete. Select Full-Text Search if you need to install Insight. Click Next.

Nexio Motion4 Server

Installation Reference

8. Show details>> to confirm no failure is present and click Next.

Database Server

9. Accept the default values for the instance configuration. Click Next.

Nexio Motion4 Server

Installation Reference

10. Click Next.

Database Server

11. Click Use the same account for all SQL Server services.

Nexio Motion4 Server

Installation Reference

12. Select NT AUTHORITY\NETWORK SERVICE from the dropdown menu and click OK.

Database Server

13. Both Windows authentication and Mixed Mode are supported, with Windows authentication mode the one most often used.



Select Windows authentication mode and click Add Current User. When finished click Next.



(Option) Select Mixed Mode, enter the password (e.g. imagine, ImagineDB1, or even longer if prompted) for the system administrator (sa) account, then click Add Current User. When finished click Next.

Nexio Motion4 Server

Installation Reference Database Server

Note: If required, an administrator familiar with SQL can change the account setting and/or the password after installation.

14. Click Next.

Nexio Motion4 Server

Installation Reference Database Server

15. Wait until the Installation Configuration Rules Wizard page is complete and then click Next.

16. Click Install.

17. On the Complete screen click Close.

Nexio Motion4 Server

Installation Reference

Verify Settings

1. Start SQL Server Configuration Manager.

Database Server

2. Verify that Shared Memory, Named Pipes and TCP/IP are enabled. Note: SQL Server must be restarted if you change the values.

3. Close SQL Server Configuration Manager.

Modify Windows Firewall Advance Settings

1. Start Windows Firewall and click Advanced settings (Not needed if every Nexio Motion Server component is installed on a single machine).

Nexio Motion4 Server

Installation Reference

2. Click Inbound Rules.

Database Server

3. Click New Rule…

Nexio Motion4 Server

Installation Reference

4. Select Port and then click Next.

Database Server

5. Select TCP. Select Specific local ports and enter the SQL Server port (1433 by default) and then click

Next.

Nexio Motion4 Server

Installation Reference

6. Click Next.

Database Server

7. Unselect Private and Public and then click Next.

Nexio Motion4 Server

Installation Reference

8. Enter SQL Server for the rule name and then click Finish.

Database Server

9. Close Windows Firewall.

Nexio Motion4 Server

Installation Reference

Motion Server

Requirements

The following requirements must be met for the Motion Server.



Operating System:



Windows® Server 2012 or later



(Included in the OS Install) Microsoft® .NET Framework 4.6 with latest Service Pack



Settings:

The server running on, or several Motion services and/or an IIS instance hosting the Motion WCF

API, must be set to the same date, time and timezone than the SQL server instance. It is recommended to use NTP to keep all the servers on the same time.

Note: If this is not done and the server time is different than the DB server time, Spy results can be delayed.

Before You Begin

Review this section to ensure the topics listed are addressed prior to installing Motion Server.

Uninstall Previous Versions

Before installing Nexio® Motion Server, uninstall any previous versions of the product.

Create Domain Accounts

The following domain accounts are necessary to install and configure Nexio Motion Server. The actual account names may be defined by the installer.

[domain]\[Administrator] – This account is a member of the Administrators group within the specified domain. The installer uses this account to log on to the servers and install the Nexio Motion Server software.

[domain]\[Motion] – This account is a member of the Users group, Performance Monitor Users group, and Administrators group within the specified domain. The installer uses this account to run Windows services that are created for Nexio Insight components, as well as to configure components.

When installing the server on a system without a domain, if the domain field is left empty (i.e. no domain), the installer automatically uses the local machine name. Leaving the domain blank is for when you install using a local user (local to the machine).

Nexio Motion4 Server

Installation Reference Motion Server

Note: The server tool automatically adds the service user (this is the Windows user that runs the services) to the Administrators group.

Note: The following accounts are referenced in later sections of this guide. These values are provided for demonstration purposes only: ‘DOMAIN\Administrator’ and ‘DOMAIN\Motion.

Installation Rules, Locations, etc.



Nexio Motion can be installed without the Nexio® Insight App Server. In turn, this allows Nexio

Motion to run on SQL Express (for small systems).



Running Motion without Nexio Insight: If no Insight Endpoint is specified during configuration,

Motion works without authentication (i.e. arbitrary credentials can be used). For configuration details see Motion4 Operations Reference.



Location of Tools folders: During installation a number of tools are installed for later use with

Motion 4. These are located in the following folders:



C:\Program Files\Imagine Communications\Motion\Server\database.tools



Database Configuration tool (dbconfig.exe)



C:\Program Files\Imagine Communications\Motion\Server\server.tools



Motion Server Configuration utility (serverconfig.exe.)



Batch files: StopAllServices.bat and StartAllServices.bat are used to start or stop all the

Motion4 services. These batch files only work when the services are installed/registered as services.



REST service: The configuration executable (restaipconfig application icon.) is included in the server.tools folder. Configuration requires providing the Motion Url, Motion user, password, logpath, and REST Service listening port.

Installing Nexio Motion Server

This section outlines the installation process for Motion Server.

Installed Prerequisites

With Motion 4.9 the following prerequisites are installed on Server 2012 as part of the Motion 4 server install. This brings the server to a working state, assuming the user sets up a connection to an SQL instance, and licenses the product.

1. The following windows features are enabled, if they are not already enabled. If they are already enabled, the installer status message will still say enabling, which indicates it is checking to see if the feature is already there:



IIS-WebServer



IIS-Security



IIS-BasicAuthentication

Nexio Motion4 Server

Installation Reference Motion Server



IIS-WindowsAuthentication



IIS-CommonHttpFeatures



IIS-ApplicationDevelopment



IIS-NetFxExtensibility45



IIS-NetFxExtensibility



WCF-HTTP-Activation



WCF-HTTP-Activation45



DesktopExperience (only enabled if the user wants the CIFS DC, aka we use HSMediaLib)

2. .Net 3.5 is installed if the user does not yet have it installed

3. Write HKLM\SOFTWARE\Microsoft\VisualStudio\10.0\VC\VCRedist\x64 &

HKLM\SOFTWARE\Microsoft\VisualStudio\10.0\VC\VCRedist\x86 installed to being 1. This is because logging checks these reg keys to check if VC++ 2010 is installed.

4. The VC++ 2015 redistributable is installed with the server and the client.

5. .Net 4.6 is installed it if it is not present.

6. HsMediaLibraries (required by the CIFS DC) are included in the Motion server MSI and are only installed if the CIFS DC is installed.



Hsmediaext.exe, and its required dlls are installed with the Motion Server in the CIFS folder, in a sub folder called hsmedia. A value added to the system Path variable allows calling hsmediaext from this new location.



On Motion server uninstall, the addition to the path variable as well as the hxmedia components are removed.

Note: Uninstalling Insight doesn't uninstall the HsMediaLibraries required by the CIFS DC.

Installing Nexio Motion Server Components

Use the following procedure to install Motion Server with all components.

Install Notes: If none of the features or prerequisites required for Motion are installed, the installer will take about 10 minutes to fully install everything.

1. Select and run the Motion Server installer. This install file covers 64 bit installations.

2. On the Welcome screen click Next.

3. On the Custom Setup screen:



To install all components select 'Motion Server'.



(Option) To install individual components, expand the list and select the subcomponent(s) to install as required.



Device Controllers are categorized into functional sub components to allow for easier selection during installation. Categories are:

CIFS

FTP

Video Processing

Telestream Vantage

Selenio Flex File

Archive

SGL Flashnet

FrontPorch Digital DIVA

Video Server

Nexio Server

Grass Valley K2

Quality Check

Digimetrics Aurora

Interra Baton

Miscellaneous

AVID Interplay

Anti Virus

Nexio Motion4 Server

Installation Reference

… Summit

FIMS

Signiant

Motion Server

4. Click the down arrow alongside the selected option and from the dropdown menu specify the location where the component will be installed (default recommended).

Nexio Motion4 Server

Installation Reference

5. On the Custom Setup screen click Next.



(Option) Click Reset to reset install parameter original settings.



(Option) Click Disk Usage to review space usage on the specified install location.



(Option) Click back to go return to the previous screen.

Motion Server

6. On the User Information Screen enter the Nexio Motion Windows user credentials that were

created earlier (See Before You Begin> Create Domain Accounts (see "Create Domain Accounts" on page 19)). When finished click Next.

Note: If not on a domain, the field can be left empty.

When the user clicks Next on the Server Setup screen, the credentials are checked. If they are not valid, or the domain cannot be accessed, the following message is displayed: "The credentials entered are not valid, are you sure you want to continue?"

The user then has the option of continuing (click Yes), or going back (click No) and fixing what they entered.

Note: If not on a domain, the field can be left empty.

Note: If no domain is specified the system uses the local machine.

7. On the ‘Ready to Install’ screen click Install.

8. Magellan Diagnostic Logger: Magellan Diagnostic logging 2.0 is installed by the Motion4.9 server installer and higher, with the logging installer running in a non-interactive mode; the user only has the option to cancel it. This results in the Diagnostic Logging installer showing and then closing when it completes and returning to the Nexio Motion Install Wizard, without requiring user interaction.



The installer only tries to install logging if it is not already installed.

Nexio Motion4 Server

Installation Reference



VC++ redistributables required by Logging are currently part of the installation



Logging’s .Net prerequisites are installed.

Note: Diagnostic Logging is not uninstalled when Motion is uninstalled.

Motion Server

9. On the Nexio Motion Completion screen click Finish.

IMPORTANT: Don't restart after the install, as suggested by Windows. Rather, run the DB tool, Server tool and Motion registration then perform a restart. Otherwise the services will try to start and will fail.

Create the Nexio Motion database

Once Motion Server is installed use this procedure to create the Nexio Motion Database.

Note: Starting with Motion 4.7 the initial DB size is set to 1GB growth to 10%, and the fill factor is set to

60.

1. Navigate to C:\Program Files\Imagine Communications\Motion\Server\database.tools folder, and run dbconfig.exe. This tool will create the Nexio Motion database.

2. Specify the following…



SQL Server Machine Name: Enter the hostname/IP address of the Database Server.



Database Name: Enter the name of the database to be created.



Database File Directory: Specify the database file path.



By default, the DB is installed in the SQL server instance data folder: C:\Program

File\Imagine Communications\Motion\Server\Database Files.



A check box allows the operator to override the default location, which then requires the user to enter the path to the DB.

Note: This folder needs to exist on the SQL server machine and that SQL Server service need to have R/W access to it.



User Name: The tool auto-populates the NT user with the information gathered from IIS (i.e.

The user credential provided at the setup time for the windows service and the app pool - along

Nexio Motion4 Server

Installation Reference with the domain is used as a default value for the User name field of the windows authentication). The user can manually change this to whatever they require.

Motion Server

3. Click Create or Run Update Script button (if you click on create then tool will create a new empty database. If you click on Run update Script then tool will update older database to the newest.)

4. Click Create.

An event log window displays about the current progress.



Errors are displayed in red in the log



Success is displayed in green



If successful, a single "OK" button is displayed.



If Failure, re-enable the main window is re-enabled so the operator can adjust the settings to correct the error and retry.

About Database Keys and Description Column

With Motion v4.5 and higher, by default the configuration Database tables are populated with all possible keys used by the system. They also have a Description column describing each setting and its value boundaries.

About the IsSystem column: IsSystem means that the server uses that setting only and the server doesn't allow to get or change that setting through the client API. (e.g.: MaintenanceMode, only the server can put itself into and step out of maintenance mode.)

Nexio Motion4 Server

Installation Reference

About the DB Cleanup Service

Motion Server

The Cleanup Service deletes Workflow Instances and related items which are older than a configured specified time.

Note: A customer's configuration is not overwritten during an upgrade.

1. Select the gear button on the top right of the standalone application.

2. The System Settings & Environment variables popup dialog is displayed.

3. Select the System Settings tab. There are only two parameter options available to access:



Cleanup Time: Possible value is a time in timespan format: DD.hh:mm:ss. Default value is 3 days.

The Cleanup Service will delete Workflow Instances and related items which are older than this specified time.



After changing this value a Cleanup Service restart is required.

Note: In Motion 4.8 the default setting of the Database’s Cleanup Time was changed from 30 days to 3 days. Since a customer's configuration is not overwritten during an upgrade, customers upgrading their system to 4.9 will show their previously set default. For example: 30

Days.

Configuring REST API

Configuration requires providing providing information, such as the Motion Url, Websocket Port, File

Notification URL, and REST Service listening port.

1. Navigate to C:\Program Files\Imagine Communications\Motion\Server\server.tools folder, and run the restapiconfig application icon.



(If Windows user access control is enabled, run it as administrator.)



This tool will do the initial configuration.

2. On the REST API dialog configure the following parameters as required.

The REST API uses the Motion system user by default (MotionSystem).

Nexio Motion4 Server

Installation Reference Motion Server



Listening port: The port on which the REST API will listen on. The default service listening TCP port is 9005. Change the port if TCP/9005 is already used by another service on your system.



Motion URL: The URL to the Motion WCF API. (The default Motion URL for the REST API is http://localhost/Motion.)



Configure connections necessary to get notifications on file changes:



Websocket Port: Specify the port that the REST API will attempt to open the file notification websocket on. If the REST API cannot open this port, it will try the next 100 in an attempt to find an open port.

Note: Currently, the websocket only notifies the user for closed/changed and deleted events.

Note: When connected to this port, the client is expected to send a message of type

MotionNotificationRestriction at which point they will start getting file change notifications of type MotionFileDescription.



On the Server configuration tool, configure "Message Service" and "Rabbit Connection" parameters. These coordinate the notification socket used by the REST API for getting notifications on file changes.

Note: The notification socket provides notifications about workflow instance status changes.

Specifically, it provides notifications of the following events: Created, Started,

ActivityCreated, ActivityProgress, ActivityCompleted, Paused, Resumed, Aborted, Failed, and

Completed.



logPath: All the logs goes to Magellan Diagnostic Logging.



Verbose Logging: Check to enable logging of all requests.



Log Folder: Click to browse for a logging folder.

3. In the Motion REST API dialog, click Save.

Nexio Motion4 Server

Installation Reference

4. Start the service by clicking the Start Service button.

Motion Server

5. Check that the service is running and communicating with the Motion system without issues by launching a web browser and navigating to http://localhost:9005/status. Change the listening port number from 9005 to the correct value, if you’re using a different number other than the default.

Note: Port 9000 is used by Diagnostic Logging.

6. Click the Save and Close button.

Configure the Server

1. Navigate C:\Program Files\Imagine Communications\Motion\server\server.tools folder, and run serverconfig.exe. This tool will do the initial configuration.

2. On the Login to Nexio Insight dialog….



Optional - Check the Use Invenio Authentication and enter the Nexio Insight Server address.



Enter the password for Admin Nexio Insight user.



Click Login.

3. On the Nexio Motion 4 Server Configuration screen…



Motion4 Database link: Edit the database connection string:



Data Source=<Hostname/IP address of Motion Database Server>



Initial Catalog=<Name of Motion Database>



Motion4 Server Address: Enter the address for the Motion4 Server: http://<address of the current computer>



Insight Server Address: If using Nexio Insight, enter the address for the Insight Server: http://<address of the current computer>



ADC Services Host name: Enter the host name for where the ADC services reside (e.g. localhost)



Message Service: Both of these pertain to the location of the Motion Message service. These settings should be a uri to which the message service was installed and the ports the user desires it runs on.



Message Service Receiver Uri: Specifies the hostname that the message service is installed on, as well as the port that this service should listen to notifications on. The rest of the motion services will send their notifications to this uri.

Nexio Motion4 Server

Installation Reference Motion Server



Message Service Sender Uri: Specifies the hostname that the message service is installed on, as well as the port that this service will send notifications out on. The services that care about these notifications will listen to this uri for any Motion notifications.



Rabbit Server: These rabbit settings are related to the Content Service. Both of these settings are required in order for Motion to send Notifications to content service over rabbit.



Rabbit Connection String: This is the connection string (in the format of the default) that connects Motion to the Content Service rabbit. Which allows Motion to send notifications out to Content service over rabbit. This string has the format of

"amqp://MotionUser:MotionPass@host/ContentHost"



Rabbit Exchange: This is the exchange on the rabbit virtual host that Motion should send the notifications to.



Services User: This is the Windows user that runs the service. The server tool automatically adds the service user to the Administrators and Performance Monitoring groups.



Insight Login/password: If using Nexio Insight, specify the login and password for the Insight

Server.

4. Click Configure.



An event log window displays about the current progress



Errors are displayed in red in the log



Success is displayed in green



If successful, a single "OK" button is displayed.



If Failure, re-enable the main window is re-enabled so the operator can adjust the settings to correct the error and retry.

Registering Motion and Starting Services

1. Before starting the services get a license for your system and register the Motion application. For details see section: Motion4 Licensing with Software Dongle.

2. Once the Motion application is registered, restart the computer.

Nexio Motion4 Server

Installation Reference Motion Server

3. After the computer has restarted it will take several minutes for the services to automatically start.

4. Confirm all the Motion services started. (Start Task Manger > Services tab)

(Option) Manually Starting a Service

Should any of the services fail to start (i.e. the Workflow manager service might fail to start the first time), they can be manually started.

Note: If some services cannot start, check the logs in Magellan Diagnostic Logging to troubleshoot.

Contact Imagine Communications Technical Support for assistance.

Use this procedure to manually start a Motion Service.

1. Open the Service Manager by clicking Start > Administrative Tools > Services.

2. Navigate to Motion Services, and start the required service.

Nexio Motion4 Server

Installation Reference Upgrading Motion4 Server and Client

Upgrading Motion4 Server and Client

Motion 4.7 Upgrade Note

The following additional steps are required when upgrading.

Workflows

During an upgrade Motion will attempt to load a workflow in the invariant culture. If that fails, it will try loading it in the system culture. Motion will also save all new/updated workflows in the invariant culture. While this will work in most cases, it will still fail if the user tries to load an old workflow created on a system that had a culture that was not the local systems or the invariant.

This means that after upgrading to 4.7, the workflow needs to be exported from that system to be importable on all (4.7+) systems. Alternatively 4.7 can be installed on a separate system, the language settings changed to Portuguese (or other required language), the workflow imported, and then the workflow exported. The resulting workflow will be importable on all 4.7+ systems, regardless of language settings.

FTP Endpoints

When upgrading to Motion 4.7 the root path of an FTP spy will be cleared and must be manually re-entered in the endpoint's parameters."

System Backup Dialog Box: configuration export

Users are warned about system backup "upgrades" that aren't supported by a message in the system backup dialog box that explains this feature is only to export a configuration to support and can only be restored on the exact same system version.

The backup contains the version number, so the user is warned when trying to restore a backup with a version different from the system version.

Preparing for the upgrade

Perform the following "check" steps before starting the upgrade.



Review and list of all currently installed devices to ensure that you have a good list of the device drivers to select when running the install.



Execute a run as command prompt with the Motion services user to ensure that you have the correct password.

Nexio Motion4 Server

Installation Reference Upgrading Motion4 Server and Client



Open SQL Management Studio on the DB server with the sa user to ensure that you have the correct password.



Open SQL Management Studio on the DB server with the Motion DB user to ensure that you have the correct password.



If integrated with ADC, ensure that you have the correct ADC Services hostname.

To upgrade Motion 4 Server and Client

1. Run StopAllServices.bat as Administrator in C:\Program Files\Imagine

Communications\Motion\Server\server.tools

2. Perform a full DB backup. The DB upgrade tool can perform this, but it will only use the default location for backup. An operator can always opt-out of the upgrade backup.

3. Check to ensure that all services are stopped and stop any that are not.

4. Uninstall the Motion Client in Control Panel – Programs and Features.

5. Uninstall the Motion Server in Control Panel – Programs and Features.

6. Install the new version of the Motion Server.

7. Run dbconfig.exe from C:\Program Files\Imagine Communications\Motion\Server\database.tools.

Run the Update Script.

Nexio Motion4 Server

Installation Reference Upgrading Motion4 Server and Client

IMPORTANT: If a DB upgrade is necessary, the tool will backup the DB automatically (to the default

SQl backup folder).

8. Navigate C:\Program Files\Imagine Communications\Motion\server\server.tools folder, and run serverconfig.exe. This tool will do the initial configuration.

IMPORTANT: Do not reuse config file backups. Config files contains reference to specific DLL versions, using a config file from a different version will cause the services to fail.

9. Run StartAllServices.bat as Administrator in C:\Program Files\Imagine

Communications\Motion\Server\server.tools

10. Check to ensure that all services are started.

11. Install the new version of the Motion Client.

Nexio Motion4 Server

Installation Reference Motion4 Licensing with Software Dongle

Motion4 Licensing with Software

Dongle

About the Dongle

A software dongle ensures customer can only use the services for which what they have paid.

Note: There is a single license for the whole system, no matter how many clients or service instances are deployed.



Implementation: Licensing currently keys on the following:

Name

Expiry

Type

DateTime

Default

02/02/2222

Licensing Checks

The system routinely performs the following licensing checks:

Overall Application License



Check on service start for valid license. The service is immediately stopped if there is no valid license.



Check at midnight (local time) every day to see if license is still valid. Everything is gracefully shut down if the license is now expired.

User information



The Motion client title bar displays a warning (yellow/orange) when the license will expire in less than 6 months.



Motion client displays an error dialog when the license is expired asking the user to contact Imagine

Communications support. Once the message is acknowledged, the client closes. The same message is displayed if the user tries to login again.



The WCF and REST services are unaffected by the licensing and will continue to run even with an expired/invalid license.



The Insight client is also unaffected by the licensing. The Insight client remains able to view and start workflows (even though they won't run) without a valid Motion server license.



After a valid license has been applied, the user needs to start the services.

Nexio Motion4 Server

Installation Reference

Licensing Process

Motion4 Licensing with Software Dongle

The following outlines the Motion4 licensing process:

1. Install Motion Server

2. User will need to either start a service or configure Motion first to make the Motion entry shows up in the RM list

3. Registration Manager is installed here: C:\Program Files (x86)\Imagine Communications\Registration

Manager\RM.exe

4. Run RM.exe to open Registration Manager

5. Click "Register" to create the .dc file which consists of the system info

6. Send the .dc file to the person that can create .rc file

7. Once receiving .rc file, open Registration Manager again

8. Click "Load RC" to load the .rc file

9. Restart IIs (IIsreset)

10. Start all the Motion Server services.

Nexio Motion4 Server

Installation Reference

Troubleshooting

Contacting Support

To communicate with a Technical Support representative use the contact information appropriate to your region.

Imagine Communications has office locations around the world. For domestic and international location and contact information, visit our Contact page

(http://www.imaginecommunications.com/company/contact-us.aspx

(http://www.imaginecommunications.com/company/contact-us.aspx) ).

Nexio Motion4 Server

Installation Reference

Appendix

Baton DC Configuration Notes

Motion 4.7 includes a new Device Controller for Interra Systems Baton quality check device and adds

Baton DC to the installer under the Video Processing group.

Operation

The Baton Quality Control Device Controller uses personal Zenium engine just for Motion (deployed with

Motion), license server, a very simple blueprint, and the Zenium Baton plug-in to provide Baton QC support. The simple Web API can submit and monitor jobs in Zenium and then retrieve the job results.

The device controller generates a package (zip file) from the original report files.

Note: Always reusing the same Zenium instance ID without disposing of it allows it to stay loaded and so saves resources.

Deployment

The Baton DC is deployed with Motion.

The Zenium Server and the Zenium Repo Server that the DC uses must be deployed separately from

Motion. Motion doesn't necessarily have to be on the same machine as the device manager (all the URLs are configurable), but the default behavior assumes that it is.

Reference Note: For details on Zenium reference the Zenium Designer Users Guide.

Support Note: Contact support for Zenium components and related distributables.

Configuration notes:

1. The location of the file needs to be added in the Content Location in Baton

2. After installing Zenium and Motion, reboot the machine. If you get Kayak license error, restarting

DRCKayakServerServices may fix it

3. After installing Kayak server and plugin, go the links below to verify they are running properly:

-- http://localhost:42100/partitions/all

-- http://wtl-jefffox:15080/console/ (You should see the Motion computer is requiring Zenium license)

4. Motion can point to Zenium Server on other machine. Just change the config file here: "C:\Program

Files\Imagine

Communications\Motion\Server\devicemanager\DeviceControllers\Baton\batondc.exe.config"

Nexio Motion4 Server

Installation Reference Appendix

5. If installing Motion first and then Zenium, run this bat file: "C:\Program Files\Imagine

Communications\Motion\Server\devicemanager\DeviceControllers\Baton\UploadPlugins.bat"

Logging

The following is provided for reference purposes.

Magellan Diagnostic Logging

The Magellan Diagnostic Logging viewer centralizes all the logging done by Motion 4.



All logging messages created by Motion 4 proper are listed under the Motion 4 application in the viewer

All the device controllers are listed under the Motion 4 Device Controllers application in the viewer.

Note: Magellan Diagnostic logging is embedded in the Motion4 server installer.

Reference Note: For information on installing, setting up, and using the Magellan Diagnostic Loggers, reference the ‘Magellan Diagnostic Logging v2_Getting Started‘ manual and ‘Magellan Diagnostic

Logging v2_Server Setup Guide‘.

Process Explorer: Diagnostic Logging Default Settings

With Motion 4.7 and higher the following are default settings for Process Explorer Diagnostic Logging:



Max storage: 4GB

Nexio Motion4 Server

Installation Reference

 file rolling size: 1GB

 default verbosity: all but info and debug

This also means that no other verbosity settings are overwritten.

Appendix

Reklamë

Installation Reference

4/12/2017

Revision: Release

Publication Information

Trademarks

Contact Information

Support Contact Information

Contents

Overview

About this Document

Application and Database Servers

Quick Install Reference

Database Server

Motion Server

Database Server

Requirements

Database Server Installation

Installing SQL Server 2012/2014/2016

Verify Settings

Modify Windows Firewall Advance Settings

Motion Server

Requirements

Before You Begin

Uninstall Previous Versions

Create Domain Accounts

Installation Rules, Locations, etc.

Installing Nexio Motion Server

Installed Prerequisites

Installing Nexio Motion Server Components

Create the Nexio Motion database

About Database Keys and Description Column

About the DB Cleanup Service

Configuring REST API

Configure the Server

Registering Motion and Starting Services

(Option) Manually Starting a Service

Upgrading Motion4 Server and Client

Motion 4.7 Upgrade Note

Workflows

FTP Endpoints

System Backup Dialog Box: configuration export

Preparing for the upgrade

To upgrade Motion 4 Server and Client

Motion4 Licensing with Software

Dongle

About the Dongle

Licensing Checks

Overall Application License

User information

Licensing Process

Troubleshooting

Contacting Support

Appendix

Baton DC Configuration Notes

Operation

Deployment

Configuration notes:

Logging

Magellan Diagnostic Logging

Process Explorer: Diagnostic Logging Default Settings

Të lidhura

Nexio Motion Server v4.7 Installation and Configuration Guide

Samsung NEXiO S160 Quick Reference Guide

Vantage Baton Integration - Application Note

D-Series D-AIS v5.10 Installation Reference

Nexio mCAPTURE User Guide

Nexio Ingest Suite v1 Operations Guide

ADC Device Server v12 12.25.74 Installation Manual

Versio v2.1 Setup Guide

Imagine Nexio G8 Family: AI Chat & PDF Access

Imagine Communications NEXIO Insight v15.1 | AI Chat & PDF Download

Nexio MOS 4.0 User Guide

Nexio Config 8.2 User Guide