Installation Guide

Prerequisites

Prerequisite for installing Moxie

Prerequisite	Description
No Magic modeling tool	One of the following No Magic modeling tools is required: Cameo Enterprise Architecture 19.0 SP4 or 2021x Refresh1 Cameo Systems Modeler 19.0 SP4 or 2021x Refresh1 MagicDraw 19.0 SP4 or 2021x Refresh1 If your No Magic modeling tool is installed in a default location (e.g., C:\Program Files\Cameo Enterprise Architecture), installing the Moxie plugin requires administrator credentials.

Prerequisite

Description

No Magic modeling tool

One of the following No Magic modeling tools is required:

Cameo Enterprise Architecture 19.0 SP4 or 2021x Refresh1
Cameo Systems Modeler 19.0 SP4 or 2021x Refresh1
MagicDraw 19.0 SP4 or 2021x Refresh1

If your No Magic modeling tool is installed in a default location (e.g., C:\Program Files\Cameo Enterprise Architecture), installing the Moxie plugin requires administrator credentials.

Prerequisites for running Moxie

Prerequisite	Description
Moxie License	A Moxie license is required to run any Moxie simulations.
Ansys License Manager	The Ansys License Manager must be running and accessible via your network, and it must have your Moxie license installed. You also need both the port number (`1055` by default) for the Ansys License Manager and the hostname of the machine running it.
No Magic plugins	Both of the following plugins to No Magic modeling tools are required: Cameo Simulation Toolkit (CST) 19.0 SP4 or 2021x Refresh1 SysML Plugin 19.0 SP4 or 2021x Refresh1 Some No Magic modeling tools already include one or both of these plugins. Check the following list in order to determine which plugins you need to install manually. Cameo Enterprise Architecture includes the SysML Plugin, so you need to manually install CST. Cameo Systems Modeler Enterprise includes both the SysML Plugin and CST, so you do not need to manually install any additional plugins. Cameo Systems Modeler Architect includes the SysML Plugin, so you need to manually install CST. MagicDraw does not include either plugin, so you need to manually install both the SysML Plugin and CST.
STK 12 (optional)	STK 12 is required to run simulations that use STK. You may need specialized capabilities within STK depending on the features that you use in your scenarios.

Prerequisites for developing delegates for Moxie

Prerequisite	Description
Java Development Kit	The Java Development Kit (JDK) is required for custom delegate development. You should use the JDK version corresponding to the Java Runtime Environment (JRE) version used by your No Magic modeling tool. You can find this in your No Magic modeling tool's main menu, under Help > About > Environment > Java virtual machine.
Gradle 5.6+ (optional)	A build tool is required for custom delegate development. Gradle is recommended, but you can build delegate modules using any Java build tool you prefer. If you choose to use Gradle, you need Gradle 5.6 or newer. A sample Gradle build script is included in the Moxie installation at \samples\build\build.gradle. For more information, see the README.txt file in the same directory.
Java IDE (optional)	A Java Integrated Development Environment (IDE) such as IntelliJ IDEA or Eclipse is recommended for custom delegate development.

Installing Moxie 1.6.0

Install the Moxie files

In the Moxie installation media, open the Moxie_v1.6.0 folder and run setup.exe.
On the Welcome page, click Next >.
On the License Agreement page, select whether or not you accept the license agreement and click Next >.
On the Install Type page, select whether to install Moxie for all users or just yourself and click Next >.
Installing Moxie for all users requires administrator credentials.
On the Destination Folder page, specify where to install the Moxie files and click Next >.
On the Ready to Install page, click Install.
On the Completed page, select whether or not to open the Moxie help, the client licensing settings, or the installer log and click Finish.

Install the Moxie plugin

Open your No Magic modeling tool and select Help > Resource/Plugin Manager.
Click Import at the bottom of the window.
Browse to the \plugin directory in the Moxie files (e.g., C:\Users\<username>\Documents\Moxie\plugin).
Select the com.agi.moxie-<version>.zip that corresponds to your modeling tool version and click Open.
If your No Magic modeling tool is installed in a default location (e.g., C:\Program Files\Cameo Enterprise Architecture), this requires administrator credentials.
Click OK on the verification dialog box. You should now see the Moxie plugin listed in gold.
Close the Resource/Plugin Manager and your modeling tool.

Configure the client licensing settings

If you do not have access to a network license server with the Ansys License Manager already running with a Moxie license, then Install the Ansys License Manager on your local machine before continuing.

Open the Moxie Client Licensing Settings via the Windows Start menu or Taskbar search box.
If you installed Moxie for all users, you must open the settings as an administrator (right-click it and select Run as administrator, entering your administrator credentials when prompted).
If you do not see the Port and Server text boxes, then select License Servers > FlexNet Publisher in the left side column, and if necessary, click the + button.
In the Port text box, enter the port for the Ansys License Manger (1055 by default).
In the Server 1 text box, enter the hostname of the machine running the Ansys License Manager.
Click the Test button to verify your settings.
Click the Save button and close the settings utility.
(Optional) Restart your No Magic modeling tool and select Moxie > About to verify your Moxie license.
Figure A1: The Moxie menu

(Optional) Configure the delegate module home

In your No Magic modeling tool, select Options > Environment.
Select Moxie from the left pane of the window.
Click the cell to the right of DelegateModuleHomePath, and then click the ... button in the right corner of the cell.
Browse to or create the folder that you will install your delegate modules to (e.g., C:\Moxie\DelegateHome). Select the folder and click Open then OK.

Troubleshooting

Please refer to the Troubleshooting page if you have any issues with installing Moxie.

Uninstalling Moxie

If you installed Moxie in a way that required administrator credentials, then uninstalling Moxie also requires administrator credentials.

Uninstall the Moxie plugin

Open your No Magic modeling tool and select Help > Resource/Plugin Manager.
In the Resource/Plugin Manager, select the Moxie checkbox.
Click Remove and then OK on the confirmation dialog box.
Restart your No Magic modeling tool. Enter your administrator credentials if prompted.

Uninstall the Moxie files (version 1.3.0 or later)

Open a Windows Control Panel via the Windows Start menu or Taskbar search box.
Select Uninstall a program.
Double-click Moxie to uninstall it. Click Yes if prompted, and enter your administrator credentials if prompted.
Close the Control Panel.

Uninstall the Moxie files (version 1.2.0 or 1.1.0)

Open a Windows PowerShell console via the Windows Start menu or Taskbar search box.
Run the following commands in the PowerShell console, replacing the path to the C:\Moxie\Moxie_v1.2.0\installer\ directory as necessary and entering your administrator credentials when prompted.
```
Set-Location C:\Moxie\Moxie_v1.2.0\installer\
Set-ExecutionPolicy AllSigned -Scope Process
.\Remove-Moxie.ps1
```
After the script completes, read through the output to confirm that there were no errors and close PowerShell.

Installing the Ansys License Manager

Installing or running the Ansys License Manager requires administrator credentials.

Install the Ansys License Manager

In the Moxie installation media, open the AnsysLicenseManager\winx64 folder and then right-click setup.exe and select Run as administrator, entering your administrator credentials when prompted. (Use the AnsysLicenseManager\linx64 installer for Linux.)
In the Ansys Installation Launcher, select Install the Ansys License Manager.
On the License Manager Shutdown dialog box, click OK.
On the License Agreement page, select whether or not you agree to the license agreement and click Next >.
On the Installation Directory page, specify where to install the Ansys License Manager and click Next >.
On the Product Selection page, click Next >.
On the Review page, click Next > to start the installation.
When the installation completes, click Next >.
Leave the Launch License Management Center upon exiting checkbox selected and click Exit.
Back in the Ansys Installation Launcher, click Exit.

Install your Moxie license

If the ANSYS License Management Center (Ansys License Manager) is not currently open, then open it via the Windows Start menu or Taskbar search box, entering your administrator credentials when prompted.
Under License File Options, select Add a License File and click BROWSE.
Browse to and select your Moxie license file and click Open.
On the Add a License File dialog box, click INSTALL LICENSE FILE.
Also under License File Options, select View FlexNet Licenses.
Note the hostname and port number from the first line of the license (SERVER <hostname> <hostid> <port>). You will need these when configuring the client licensing settings.
(Optional) Under Home, select View Status/Start/Stop License Manager to verify that the license manager is running.
Close the Ansys License Manager

Troubleshooting

Please refer to the Troubleshooting help topic if you have any issues with installing the Ansys License Manager.