Documente Academic
Documente Profesional
Documente Cultură
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. A list of resellers is available
on our website at www.antennamagus.com.
We are interested in hearing your feedback on everything, but especially:
1. Licensing and Pricing
2. User interface
3. Antennas, Articles, Transitions or Array-layouts. Specifically, if there are antennas, arraylayouts or information you would like to see included in Antenna Magus, please send them
through.
Hardware
Antenna Magus has been designed for use on standard 32 or 64-bit PC hardware running Windows
Server 2003, Windows Server 2012, Windows Vista, 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.
.Net 4.5.2 is available on all Antenna Magus DVDs 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 hasnt.
Installation of the .NET Framework may require a reboot.
Evaluation version
The Evaluation version 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 Evaluation version, you will only be able to work with a very 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.
Classroom version
The Classroom 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 Classroom
version is a 20-digit key (whereas the Professional version uses a 15-digit key). A Classroom licence
key can be used concurrently on a number of machines up to the maximum of the number of seats
allocated for the Classroom 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 Classroom
installation is installed, please contact your Antenna Magus reseller.
Each Classroom 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.
Professional version
In order to install and run Antenna Magus Professional for the first time you must have the
installation files and 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.
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.)
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.)
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.
Automatic licence retrieval (Internet connection required)
After launching the Antenna Magus Floating Licence Manager, click on the Update button to open
the Update licence dialogue. Fill in the 15-digit floating licence key into the Licence key field and click
on the Download button. Note that the key is required in the correct format, including the dashes
(xxxx-xxxx-xxxxxxx) as shown below.
Antenna Magus will request a licence file for the inserted key over the internet and display the
licence information. If the information is correct, click the Apply button to start using the retrieved
licence.
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.
Manual licencing (Where no internet connection is available)
Where no internet connection is available, the host information of the licence server machine must
be provided to your Antenna Magus Reseller so that they can create a licence file for you manually.
Installation Guide - Version 2016 and later
www.antennamagus.com
To obtain the host information, start up the licence manager, press the Update button and select
the Host Info tab as shown below. The information required by the Reseller is shown in the text field.
This information may be copied and pasted into an email.
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.
Managing an Antenna Magus Floating Licence
The status of an instance of the Antenna Magus floating licence can be viewed and controlled from
the Antenna Magus Floating Licence Manager main window, as shown below. Once the floating
licence service has been started, the Antenna Magus Floating Licence Manager application may be
closed and the floating licence service will continue to run on the machine.
The floating licence service may be started and stopped using the Start and Stop buttons. The port
that the licencing service is to communicate with client machines on may be changed at any time.
Changes need to be applied by clicking on the Apply button. A log of all activity on the floating
licence network can be accessed by clicking on the View log button. This log will contain
information about the usage of the floating licence, as well as errors and warnings that may have
occurred on the system.
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.
Managing the list of named users
(NOTE: only applicable for Silver floating licences and older versions of the Floating
Licence Manager)
Before the floating licence server can be started on a Silver floating licence setup, the list of named
users that are able to access the licence needs to be set up (Note that an error will occur if this list
has not been setup). The user list can be opened by clicking on the Edit named users button, as
shown below.
Users may be added to the list by clicking the Add user button. The username (Windows login name)
of the intended user must then be entered. Any number of users may be added to the list, but only
the users marked as Active will be able to access the floating licence. The user list may be reordered
by selecting a user and clicking Move up or Move down. The users that are currently active is
determined by position in the list (the users in the first 3 positions are active).
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.
Installing Antenna Magus on a client machine in a floating licence network
In order to install Antenna Magus for use with a floating licence option, the floating licence server
must already be installed and started on the floating licence host machine (as discussed in the
previous sections) and the machine must have local area network connectivity to the floating licence
host machine when Antenna Magus is started after installation.
Complete the Antenna Magus installation on the client machine and startup 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.
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.
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.
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/
AWR Design Environment must be installed and licenced on the machine where the
conversion is to be performed
Antenna Magus Elements Foundry Library is installed on the machine where the conversion
is to be performed
The installation file for the Antenna Magus Elements Foundry Library is available on the Antenna
Magus website, and may be found on the Antenna Magus installation DVD.
After installation of the Antenna Magus Elements Foundry Library files with the *.am-emp extension
will be associated with the file conversion utility. Double-clicking on an *.am-emp file will convert
the file to an *emp file and open the project in AWR Design Environment if the required licences are
in place.
In addition to the conversion utility, Antenna Magus Elements Foundry will also install an AWR
Design Environment PDK that contains elements used by specific Antenna Magus generated models.
These elements need to be in place in order to use these models in AWR Design Environment.
Periodically, when opening a project in AWR Design Environment, a prompt may indicate that the
PDK elements need to be updated or expanded. This will require re-installation of a newer version of
the Antenna Magus Elements Foundry Library to ensure that Antenna Magus generated projects to
operate correctly in the AWR Design Environment.