Motion Server. Imagine communications Motion4 Server

PDF

Dokument

Reklama

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)