Prerequisite installation

There are Windows settings and applications that work with Moxie that must be installed and configured before installation can start.

If a new installation of Moxie Studio or Player is being performed, SQLlite (7.07 and higher available here) or Microsoft SQL Compact Server (7.06 and lower, no longer supported by Microsoft) must be installed first.

Ensure that the .NET Framework is 4.6.1 or higher and the correct version of Microsoft Visual C++ Redistributable has been installed.

Installation

1. Obtain MSI file from Omnivex Technical Services and place it in C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$
2. Install Moxie Studio or Player

   When performing a silent installation of Studio or Player, a command containing all parameters and configuration details must be entered into the Command Prompt. The commands are different depending on whether the Moxie Studio, Player or both are being installed.

   In the Command Prompt, change directories to C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$.

   As one, unbroken line, type the following commands to install:

   • Moxie Studio:
     msiexec /i "C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$\Omnivex Moxie Setup.msi" ADDLOCAL="Placeholder,Agent,Studio,ireport,DataServerConnection" /quiet
   • Moxie Player:
     msiexec /i "C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$\Omnivex Moxie Setup.msi" ADDLOCAL="Placeholder,Agent,Player,ireport,DataServerConnection,RemoteDeployConsole" /quiet
   • Moxie Studio and Player:
     msiexec /i "C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$\Omnivex Moxie Setup.msi" ADDLOCAL="Placeholder,Agent,Player,Studio,ireport,DataServerConnection,RemoteDeployConsole" /quiet

   The above commands contain the following elements:

   Element	Description
   msiexec /i "C:\ProgramData\Omnivex\Moxie\$MoxieInstaller$\Omnivex Moxie Setup.msi"	start the Moxie MSI installation
   ADDLOCAL=" "	A quote enclosed list of Moxie components to install
   Placeholder	Mandatory: constructs the installation directory structure
   Agent	Mandatory: installs necessary Agent components
   Player	Optional: Only if installing Moxie Player on this computer
   Studio	Optional: Only if installing Studio on this computer
   ireport	Mandatory: installs the ireport components which are used for remote Player and Studio functionality as well as troubleshooting.
   DataServerConnection	Optional: A tool for manually starting the Data Server Connection Wizard.
   RemoteDeployConsole	Optional: Only if installing Moxie Player on this computer. Required for Moxie Player remote upgrades.
   /quiet	Optional: Suppresses all dialogs during installation

3.  Configure your Player or Studio to connect to the Data Server

   A new install of Moxie Player or Studio must connect to its Data Server to access data and content.

   Start the application Notepad and copy and paste the following code block into a new document.

   • <?xml version='1.0' encoding='UTF-8'?>
     
     <ComputerAlias>
     
     <ComputerAliasName />
     
     <ComputerName />
     
     <Domain />
     
     <Forest />
     
     <DataServer>
     
     <DataServerTransport>Computer Name</DataServerTransport>
     
     <DataServerAddress>The_DataServer</DataServerAddress>
     
     <DataServerAliasName>Data Server</DataServerAliasName>
     
     <DataServerQueue>2293</DataServerQueue>
     
     <DataServerGuid />
     
     <DataServerPassphrase>YourPassphrase</DataServerPassphrase>
     
     <DataServerComputerAlias>The_DataServer</DataServerComputerAlias>
     
     </DataServer>
     
     <PlayerIDs>
     
     <PlayerID id="YourID"/>
     
     </PlayerIDs>
     
     </ComputerAlias>

   In the tag:

   • DataServerTransport, enter the text Computer Name.
   • DataServerAddress, enter the Data Server computer's hostname or IP address. In this example, The_DataServer has been entered.
   • DataServerAliasName, enter the text Data Server.
   • DataServerQueue, enter the Port number used for communication with the Data Server. In this example, the default port number 2293 has been entered.
   • DataServerPassphrase, enter the passphrase for connecting to the Data Server, if this has been configured. If there is no passphrase configured, replace <DataServerPassphrase>YourPassphrase</DataServerPassphrase> with 
     
     <DataServerPassphrase />
   • DataServerComputerAlias, enter the Data Server computer's hostname. In this example, The_DataServer has been entered.
   • PlayerIDs, create a tag for each Player ID, if applicable (typically only one, unless you are going to have multiple players running on a single computer). Player IDs are created from the System Manager module. If you don't have Player IDs enabled, then remove the YourID  from the quotations as such <PlayerID id=""/>. 
4. Save the file in Moxie\Agent\Preload in the install directory, and name the file AliasConnection.xml.
5. In the Command Prompt, type: net start "Omnivex Moxie Agent" to start the Moxie Agent service.
6. In the Command Prompt, type: shutdown -r -t 60 to restart the computer after a 60-second pause.

When the Player or Studio computer restarts, the Moxie Agent has already established the connection to the Data Server. The Moxie Player then starts automatically a few minutes after logging onto your computer.If the Moxie Player installation is configured with a shortcut in the system Startup directory, system startup and Moxie Player start can be automated.