Beruflich Dokumente
Kultur Dokumente
1. Hardware .................................................................................................................................... 2
2. Prerequisites for installation ....................................................................................................... 2
3. Evaluation version ....................................................................................................................... 3
4. Teaching version ......................................................................................................................... 3
5. Professional version .................................................................................................................... 3
a. Using a CST STUDIO SUITE® 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 (recommended) .............................................................................. 4
c. Using stand-alone Node-locked licensing for Antenna Magus Professional on a machine
WITHOUT an internet connection (manual installation - not recommended) ............................... 5
d. Using a stand-alone Floating (network) licence for Antenna Magus Professional ................. 6
e. Installing Antenna Magus Professional on a client machine in a floating licence network.. 10
f. Periodic updates of your licence ........................................................................................... 11
7. Installing an update of Antenna Magus ........................................................................................ 12
8. Moving a licence to a new machine.............................................................................................. 12
10. What is an MD5 Checksum? ....................................................................................................... 12
11. How to retrieve hostname and machine codes .......................................................................... 13
Need more help? .................................................................................................................................. 13
1. Hardware
Antenna Magus has been designed for use on 64-bit PC hardware running Windows Server 2003,
Windows Server 2012, Windows 7, Windows 8 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.
If you do not have Microsoft .NET Framework 4.5.2 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=42642.
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.
When running the Evaluation version, 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 Evaluation version. 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 Evaluation version expires periodically. The expiry date of the Evaluation version is displayed in
the title bar of the application window. If the version you have has expired, please visit
www.antennamagus.com 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
Evaluation version; 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.
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® FlexLM license file with the Antenna Magus module activated
- An Antenna Magus license file generated using the hostname and machine codes for the
target machine OR for a stand-alone floating license server. (The methods for retrieving this
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.
Installing Antenna Magus to use a CST STUDIO SUITE® license generally requires no special
configuration of Antenna Magus. The CST STUDIO SUITE® 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.
If Antenna Magus fails to resolve the license, then the Hostname and Port on which the CST STUDIO
SUITE® license service is available can be entered at Option 3: Connect to a floating 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.
To install without communication with the Antenna Magus licence server, install and run Antenna
Magus. When prompted to provide licencing information, switch to the Host Info tab of the licence
dialogue.
After sending the information, you must wait for your reseller to provide you with a file named
‘secmagus.dat’ that contains the unique licence information for your machine.
When you have received a licence file, start Antenna Magus. When prompted to provide licencing
information, click on the Browse… button under the Option 2: Specify the location of the licence file
to use. Browse to the location of the secmagus.dat file, select the file and click Open. Antenna Magus
will apply the licence provided in the selected secmagus.dat file.
Note that automatic licence retrieval must be disabled in the Antenna Magus Settings dialog should
you wish to prevent Antenna Magus from updating your license automatically after installation. (See
the FAQ for a detailed explanation of the Antenna Magus settings.)
In the case of a Silver floating licence (only applicable to unmaintained licenses purchased before
2015) there is an additional limitation on the specific users that may access the floating licence. The
The FLM must be installed using a separate installation to the Antenna Magus installation. The file
‘AntennaMagusLM.msi’ can be downloaded from the Antenna Magus website, or found on the
Antenna Magus DVD. The installation of the floating license manager does not require the .NET
framework to be installed on the server.
To install the Antenna Magus floating licence manager, execute the installer *.msi and follow the
prompts. After installation, the Antenna Magus Floating licence manager can be launched.
The generation of a licence for the floating licence server may be done by sending the host
information of the server to your reseller, or by typing in your floating licence key and requesting
that the licence file be automatically retrieved over the internet. Where possible, we suggest that
the option for automatic retrieval of the licence information be used.
After applying the licence, confirm that the licencing service has been correctly started by clicking on
the Start button in the Floating Licence Manager main window.
Your reseller will provide a floating licence server licence file based on the floating licence host
machine information. The Antenna Magus Floating Licence Manager should be pointed to this
licence file using the Browse button on the Licencing tab of the Update licence window shown
above. The information about the floating licence file selected will be displayed. If the information is
correct, click Apply to start using the licence.
NOTE: Depending on the operating system configuration on the floating licence server host machine,
it may be necessary to open up the selected port for Antenna Magus floating licence communication
in the machines firewall or security software.
In the case of a Silver floating licence, a list of named users that are eligible for access to the licence
must be set up before the server can be started. The management of named users is discussed in the
next section.
A selected user may be removed from the list by clicking Remove user. Specific activity of users may
be found in the log file to help troubleshoot and identify problems and usage patterns.
If any changes have been made to the user list, the FLM should be stopped and restarted before the
changes will be applied. In the case of a Gold floating licence, the named user list will have no effect
on the operation of the licence.
Complete the Antenna Magus installation on the client machine and start up Antenna Magus. When
prompted to provide licencing information, insert the host-name of the floating licence host
machine, and the port on which the floating licence service is running (this can be changed on the
Floating Licence Manager application as discussed below) in Option 3: Connect to a floating licence
server.
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.
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.
On a network using a floating licence system, the Antenna Magus Floating Licence Manager may
periodically need to be reinstalled. An error message will be given when running Antenna Magus on
a floating licence client machine indicating that the Floating Licence Manager should be updated. A
new version of the Antenna Magus Floating Licence Manager can be downloaded from the Antenna
Magus website (www.antennamagus.com) and installed.
The floating licence service of the existing Antenna Magus Floating Licence Manager application
should be stopped before the new manager is installed.
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/
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
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