Installation Guide

Welcome to Antenna Magus! If you are having trouble with the installation of Antenna Magus, or
would like any further information, please feel free to contact a reseller or our support team at
SIMULIA.CST.ZA.Hotline@3ds.com.

We are interested in hearing your feedback on everything, but especially:

1. User interface
2. Antennas, Articles, Transitions or Array-layouts. Specifically, if there are antennas, array-
layouts or information you would like to see included in Antenna Magus, please send them
through.

Table of Contents
1. Hardware............................................................................................................................... 2
2. Prerequisites for installation .................................................................................................. 2
3. Student Edition ...................................................................................................................... 2
4. Teaching version .................................................................................................................... 3
5. Professional version ............................................................................................................... 4
a. Using a CST Studio Suite® FlexLM license to run Antenna Magus Professional .................... 4
b. Using stand-alone Node-locked licensing for Antenna Magus Professional on a machine
WITH an internet connection (Legacy Magus licence) ................................................................ 7
c. Installing Antenna Magus Professional on a client machine in a floating licence network ... 8
d. Periodic updates of your licence ......................................................................................... 9
7. Installing an update of Antenna Magus .................................................................................... 10
8. Moving a licence to a new machine ......................................................................................... 10
10. What is an MD5 Checksum? ................................................................................................... 10
11. How to retrieve hostname and machine codes ...................................................................... 10
12. Need more help? ................................................................................................................... 12

Installation Guide - Version 2021 and later

Visit Antenna Magus online
1. Hardware
Antenna Magus has been designed for use on 64-bit PC hardware running Windows Server 2008,
Windows Server 2012, Windows 7 or Windows 10. For Node-locked licencing, no network
connectivity is required, but the licensing procedure is simplified by allowing Antenna Magus to
connect to the internet.

For floating licence use, all machines that are to use the floating licence must be connected to the
same local-area-network as the floating licence server machine while Antenna Magus is open. If the
client machines loose network connectivity to the floating licence server for more than a few
minutes, Antenna Magus will give an error and cease operation until the connection is restored.

2. Prerequisites for installation

The Antenna Magus installation requires that a user with administration rights executes the
installation. It is important to note that the Student, Teaching and Professional versions of Antenna
Magus use different installations. Please ensure that you have downloaded the correct installer or
have received the correct DVD.

If you do not have Microsoft .NET Framework 4.7.1 installed, the necessary .Net components will be
installed automatically if possible. If this fails, please install the full .Net manually. The stand-alone
.Net installation is available on all Antenna Magus DVD’s or from Microsoft at:

https://www.microsoft.com/en-za/download/details.aspx?id=56116.

Note: The installation of the .NET Framework can be VERY slow – it has been known to take up to
half an hour and longer. Lack of progress feedback can make it look like the installation has stopped
responding, when in fact it hasn’t. Installation of the .NET Framework may require a reboot. The
.NET framework is NOT required on the server that will host the floating license server, only on
machines that will run the client application.

3. Student Edition
The Student Edition of Antenna Magus requires no licence keys or registration for installation. The
installation executable is named ‘AntennaMagus(Evaluation).exe'. This file should be copied to a
local folder and executed, or the ‘setup.exe’ file on the Antenna Magus Evaluation DVD should be
executed.

When running the Student Edition, you will only be able to work with a small subset of the antennas
that are available in the licensed version of the product and will not be able to work with custom
Antenna Templates. All the features of the licensed product can be used with the antennas that are
active in the Student Edition. The number of design algorithms in the Array Synthesis tool is
restricted, as is size of the array that can be imported. To get access to the full database and the full
array synthesis tool, please contact a reseller to purchase Antenna Magus.

The Student Edition expires periodically. The expiry date of the Student Edition is displayed in the
title bar of the application window. If the version you have has expired, please visit

Installation Guide - Version 2021 and later

Visit Antenna Magus online
https://edu.3ds.com/en/software/antenna-magus-student-edition for the latest version, or ask your
Antenna Magus reseller for a new installation DVD.

4. Teaching version
The Teaching version of Antenna Magus (which provides access to a larger subset of antennas than
Student Edition; custom Antenna Templates are not available) is installed in exactly the same
manner as the Professional version (discussed below). The licence key required to use the Teaching
version is a 20-digit key (whereas the Professional version uses a 15-digit key) and FlexLM based
licensing is not supported.

A Teaching licence key can be used concurrently on a number of machines up to the maximum of
the number of seats allocated for the Teaching licence. Once installation has been completed on the
maximum number of machines, the key will cease to work. In order to change the machines on
which the Teaching installation is installed, please contact your Antenna Magus reseller.

Each Teaching version installation is locked to a specific machine, but is sufficiently robust to be used
in computer centres where machine setups and installations may be cloned or machines are
periodically reverted to a snapshot state. It is possible (dependant on the system setup) that the
user may be required to re-enter the licence key when the Antenna Magus is started up after
changes have been made to the machine.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
5. Professional version
In order to install and run Antenna Magus Professional for the first time you must have the
installation files and either:

- A CST Studio Suite® license manager or Dassault Systèmes License Server (DSLS) with the
Antenna Magus module activated

- A 15-digit licence key. The licence key should have been supplied to you by your reseller. If
you are not in possession of this key, please contact your reseller – you cannot run Antenna
Magus Professional without it.

To install Antenna Magus with an internet connection, simply run the installation and follow the on
screen prompts. After installation, launch Antenna Magus from the Start Menu. If a valid licence file
is not available on your machine from a previous installation, you will be prompted to provide
licencing information.

a. Using a CST Studio Suite® FlexLM license to run Antenna Magus Professional
If you have a CST Studio Suite® FlexLM license with the Antenna Magus module activated, then it is
possible to run Antenna Magus Professional using this license. This option is available for Antenna
Magus 2017 and onwards and users wishing to use this option should contact their CST Support
channel to get more information about the licensing options.

i. CST Studio Suite is also installed on computer

Installing Antenna Magus to use a CST Studio Suite® license generally requires no special
configuration of Antenna Magus. The CST Studio Suite® FlexLM license should be installed and
running on the network or machine according to the CST Studio Suite® installation guide before
installing Antenna Magus. In most cases, the Antenna Magus installation will automatically resolve
the license at start-up.

When installing Antenna Magus ensure that the Setup FlexLM licensing after installation is
unchecked.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
If Antenna Magus fails to resolve the license, then the Hostname and Port on which the CST Studio
Suite® FlexLM license service is available can be entered at Option 2: Connect to a license server on
the Antenna Magus license dialogue. Antenna Magus will then retrieve license information from the
indicated location.

In the event of a multiple redundant license server setup, the Hostnames and Ports of the redundant
servers should be entered in a comma-separated list in the Hostname and Port fields before
initiating the connection.

ii. CST Studio Suite® is not installed on computer

If your licence includes a module for CST Studio Suite®, but it is not yet installed, it is recommended
to install CST Studio Suite® first, according the CST Studio Suite® installation guidelines and then
follow the steps in section 5.a.i above. If your CST Studio Suite® FlexLM Licence does not include a
CST Studio Suite® module, i.e. you have a licence for Antenna Magus, but not for CST Studio Suite®
then you need to the configure the FlexLM licencing after the Antenna Magus installation. To do this,
ensure that the Setup FlexLM licensing after installation is checked when installing Antenna Magus.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
If for some reason this option was not checked during installation, the licensing setup can be done
by running the LicenseWizard.exe file located in the Antenna Magus installation directory:
C:\Program Files\Antenna Magus\Solver\License Manager.

Select the first option and browse to the location of the *.dat file which you received from your
reseller.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
b. Using stand-alone Node-locked licensing for Antenna Magus Professional on a
machine WITH an internet connection (Legacy Magus licence)
When prompted to provide licencing information, enter your 15-digit licence key in the Licence key
under Option 1: Retrieve licence using my internet connection. Antenna Magus will send your key
together with your hardware serial numbers to the Antenna Magus server. The server will respond
with the required licence file for the installation process to continue. If you experience trouble with
this step, please refer to the section on installation without an internet connection.

What information does the installation send to the server?

Antenna Magus is licensed for use on a single desktop PC and each licence is linked to a unique set of
hardware serial numbers. The installation sends the licence key and the serial numbers of the
machine to the licence server, so that a licence can be created for the machine. This information
does not contain anything that can be used to identify you; it only contains data about your
operating system and hardware. (If you would like to see the information that is being sent, select
the Host Info tab in the licence dialogue. The content is identical to the information that you would
need to send to your reseller as part of a request for a manually created licence file.)

Installation Guide - Version 2021 and later

Visit Antenna Magus online
c. Installing Antenna Magus Professional on a client machine in a floating licence
network
Antenna Magus may be installed for use with a floating licence server. To facilitate this option, a
floating licence server with active Antenna Magus licence must be installed prior to installation.
Supported floating licence server types include CST Studio Suite, DSLS and Antenna Magus (Legacy
licence type). Additionally, the installation machine must have local area connectivity to the floating
licence host machine.

Complete the Antenna Magus installation on the client machine and start up Antenna Magus. When
prompted to provide licencing information, choose the appropriate licensing scheme and insert the
floating licence host machine name, and the port on which the floating licence service is running in
Option 2: Connect to a licence server.

Click Connect. Antenna Magus will now contact the floating licence host for licencing information.
This will be repeated at start-up and while Antenna Magus is running. If a communication or licence
error occurs, or if the licence host is stopped this licence dialogue will reactivate and indicate the
problem.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
NOTE: depending on the permissions configuration of the machine, it may be necessary for an
exclusion to be added to your firewall or security administration tools to allow communication on
the chosen port between the floating licence host machine and the client machines.

d. Periodic updates of your licence

For security reasons, your Antenna Magus licence will get stale from time to time. When this
happens, Antenna Magus will attempt to get a new licence from the Antenna Magus server. Should
this process fail (because you are not connected to the internet or because you have opted out of
the automatic checking mechanism), you will need to contact your reseller for an updated licence.
Antenna Magus will inform you that you need a new licence 2 weeks before the expiry of your
current licence.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
7. Installing an update of Antenna Magus
Updates for Antenna Magus are available from one version to the next. These updates can be
downloaded from https://software.3ds.com/. If you have missed an update, you must either install
the missing update(s) before installing the latest one, or uninstall Antenna Magus and re-install using
the latest full installation.

If you are connected to the internet, and your maintenance and support contract is paid up, the
update process is unlikely to encounter problems. If you encounter any problems, please contact
your reseller.

If you are not connected to the internet, it may not be possible for the installation to check the
status of your maintenance and support contract. If the installation reports that your contract is out
of date, and you believe this to be a mistake, you should contact your reseller for an updated licence
file. Once you have received and correctly installed your licence file, the update installation should
complete.

8. Moving a licence to a new machine

In the event that you need to move your Antenna Magus installation to a new computer, you need
to notify your reseller. Once your reseller has indicated that you may proceed with the intended
move, you can install in the normal way. Note that Antenna Magus will stop working on the machine
where it was previously installed.

10. What is an MD5 Checksum?

Every now and then, for some or other reason, errors occur during file downloads, resulting in
corrupt files. These errors are not picked up by the download manager and are often a source of
frustration. MD5 Checksums are used as a quick way to verify whether or not this has happened. We
calculate the MD5 checksum of the file on our server and publish it on the internet. After you have
downloaded, you are encouraged to calculate the checksum and compare it to the one on the
website. If there is a difference in the checksum, you need to re-do the download. Note that if you
have a local cache, it may return the corrupt file to you again!

For MS Windows, MD5 checksums are often built into popular tools like Total Commander. If you
don't have this, some popular tools for generating MD5 checksums are available at:
http://www.fastsum.com/
http://www.fourmilab.ch/md5/
http://www.toast442.org/md5/
http://www.pc-tools.net/win32/md5sums/

11. How to retrieve hostname and machine codes

For the various licensing options available, different information is needed.

Installation Guide - Version 2021 and later

Visit Antenna Magus online
For licensing using CST Studio Suite® FlexLM licensing or DSLS
For this case, the hostname and MAC address of the target machine on which CST License Manager
or Dassault Systèmes License Server (DSLS) is to be run is required. The MAC address can be
determined by running the command ‘getmac’ in a command-prompt on the machine, while the
hostname can be determined by running the command ‘hostname’ in a command prompt on the
machine.

The host Info for the machine on which Antenna Magus is installed may be retrieved by going to the
Host Info tab when prompted for licencing information at start up. Compact and Expanded format
machine codes are available.

For stand-alone licensing of Antenna Magus Professional

For this case, the hostname and Antenna Magus machine codes are required. Both of these may be
retrieved in one of 3 ways:

1. Install Antenna Magus on the target machine. When starting Antenna Magus, a licensing
window will appear. Click on the ‘Host Info’ tab copy the machine code and hostname
information from there. In older versions of Antenna Magus (before 2019) only one format

Installation Guide - Version 2021 and later

Visit Antenna Magus online
 for the machine codes is available, while for newer versions both Compact and Expanded
versions are available. The Compact version is preferred where possible.
2. Install the stand-alone Antenna Magus Floating license manager on the target machine.
Startup the FLM and retrieve the machine information as described in the section ‘Using a
stand-alone Floating (network) licence for Antenna Magus Professional’ earlier in this
document.
3. Download and copy the executable available at the link below and run this executable in a
command-prompt on the target machine (or double-click to execute the executable). This
will print out the necessary information to the command-prompt screen from where it may
be copy-pasted.
Link to machine code executable download

12. Need more help?

If, after reading this guide, you are having trouble with the installation of Antenna Magus, please
contact your reseller or Antenna Magus Support at SIMULIA.ZA.Hotline@3ds.com. If you are having
difficulties installing the Student Edition, you can contact us here.

Installation Guide - Version 2021 and later

Visit Antenna Magus online