MagiCAD For Revit Installation Guide 2024

Download as pdf or txt
Download as pdf or txt
You are on page 1of 19

Installation Guide

MagiCAD 2024 for Revit 2021-2024


2 (19)

Table of Contents
GENERAL .................................................................................................................................................. 3
SYSTEM REQUIREMENTS ............................................................................................................................ 3
SETUP ARCHITECTURE............................................................................................................................... 3
SELECTING INSTALLATION PACKAGE ........................................................................................................... 4
UPDATING EXISTING SOFTWARE ................................................................................................................. 5
INSTALLING MAGICAD ON A SINGLE WORKSTATION ....................................................................... 6
HOW TO CHECK THE INSTALLED MAGICAD RELEASE VERSION ................................................................... 11
LICENSING .............................................................................................................................................. 11
PROGRAM DIRECTORY STRUCTURE ................................................................................................. 12
EXECUTABLE FILES .................................................................................................................................. 12
LOCATION OF FILES THAT CAN BE MODIFIED AT RUNTIME ............................................................................ 12
STARTING THE PROGRAM ................................................................................................................... 13
MAGICAD PLUGIN MANAGER .................................................................................................................. 13
CHECKING FOR UPDATES.................................................................................................................... 14
INSTALLING MAGICAD ON MULTIPLE WORKSTATIONS ................................................................. 15
MSI INSTALLATION PACKAGE.................................................................................................................... 15
Sample installation batch files ........................................................................................................... 16
EXE INSTALLATION PACKAGE ................................................................................................................... 17
Sample installation batch files for exe package ................................................................................ 17
Silent installation of patch package ................................................................................................... 17
FREQUENTLY ASKED QUESTIONS ..................................................................................................... 18
WHY DOES THE INSTALLER DISPLAY THE WARNING ”REVIT IS NOT FOUND”? ................................................ 18
WHY DO I GET SCHNEIDERELECTRIC SERVICE POPUP DURING INSTALLATION? ............................................ 18
SCHNEIDER ELECTRIC ECODIAL PLUGIN FOR AUTOCAD DETECTED, WHAT SHOULD I DO? .......................... 19
WAS THE PATCH INSTALLED SUCCESSFULLY? I CANNOT FIND IT IN PROGRAMS AND FEATURES (INSTALLED
APPS IN WINDOWS 11)............................................................................................................................. 19

HOW CAN I UNINSTALL A PATCH? .............................................................................................................. 19

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
3 (19)

GENERAL
SYSTEM REQUIREMENTS

MagiCAD for Revit version 2024 runs on


• 64-bit version of Autodesk Revit 2021
• 64-bit version of Autodesk Revit 2022
• 64-bit version of Autodesk Revit 2023.1
• 64-bit version of Autodesk Revit 2024

SETUP ARCHITECTURE

This chapter describes MagiCAD installation on a single workstation. In larger corporate networks also
silent installations may be performed; in these cases, see chapter “Installing MagiCAD on multiple
workstations” and contact MagiCAD technical support if necessary.

Administrator privileges are required when running MagiCAD Setup.

The installer contains the following applications:


• MagiCAD for Revit
• License Management Utility
• Check for Updates
• MagiCAD Plugin Manager
• Supports & Hangers
• MagiCloud Connect

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
4 (19)

SELECTING INSTALLATION PACKAGE

First, go to MagiCAD Download Portal:


https://portal.magicad.com/Download/GetProductCategoryList?categoryId=1

Note: Before beginning the installation process, please familiarise yourself with the instructions
on installation and license activation in this Installation Guide.

In the MagiCAD Download Portal, the EXE and MSI installation packages are available in the
MAGICAD PRODUCT section. With Update Releases, you also have the option to download the
relevant installation package directly via MagiCAD’s Check for Updates function.

Both of the installation packages install the full version of the MagiCAD Release, but there are
differences in the installation procedure. Select the procedure which best suits your needs:

1. MagiCAD 2024 for Revit (EXE)


• For manual installation. This is the default installation option for users who have
administrator rights.
• Can be installed silently via command line, but the only available parameters are
language and install location. If you need more installation parameters, use the MSI
package

2. MagiCAD 2024 for Revit (MSI) (---System Administrators---)


• This is the default installation option for System Administrators
• Use this package if you have to use command line parameters
• Must be installed from Admin Command Prompt

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
5 (19)

UPDATING EXISTING SOFTWARE

With Update Releases, when updating your existing installation, you have the option to download the
relevant installation package directly via MagiCAD’s Check for Updates function.

Note: Before beginning the installation process, please familiarise yourself with the instructions
on installation and license activation in this Installation Guide.

There are three different Update Release installers available in the MAGICAD PRODUCT section of the
Download Portal:

1. MagiCAD 2024 Update Release for Revit


• If you do not have MagiCAD 2024 installed, select this package. If you have MagiCAD
installed, you need to uninstall it before installing this package. The package installs
both MagiCAD 2024 Release and Update Release Patch.

2. MagiCAD 2024 Update Release for Revit – patch (---MagiCAD Update---)


• An existing MagiCAD 2024 installation must be found on the PC. If you have MagiCAD
2024 release already installed on the PC, use this installation package. The newest
patch will always include the previous Update Releases. Activation codes are not
needed for the Update Release patch installation

3. MagiCAD 2024 for Revit (MSI) (---System Administrators---)


• This MSI package does NOT include Update Release Patch.
• Upgrade to Update Release by installing MagiCAD 2024 Update Release for Revit -
patch
• Use this package if you have to use command line parameters

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
6 (19)

INSTALLING MAGICAD ON A SINGLE WORKSTATION


This chapter describes MagiCAD installation on a single workstation. In larger corporate networks also
silent installations may be performed; in these cases, see chapter “Installing MagiCAD on multiple
workstations” and contact MagiCAD technical support if necessary.

Administrator privileges are required when running MagiCAD Setup.

Run the setup package and follow the instructions.

If User Account Control is enabled, installation requires permission to continue. If this dialog appears,
click Yes.

Select the installation language and click Begin.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
7 (19)

Customers with existing MagiCAD Network Licenses need to update their license server to
version 19.05 or later before installing MagiCAD 2024. Read More...

Check the note and click Next.

You must read and accept the license agreement to proceed with the MagiCAD Setup procedure.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
8 (19)

Next, select the User Interface Language for MagiCAD. Select the Destination Folder. If you want to
change the default folder, click Change and select a new Destination Folder. Click Next to continue.

During MagiCAD installation it is now possible to install additional tools which will make design work
easier. It is optional but recommended to install the following applications:
MagiCAD Connect enables you to access MagiCAD Cloud libraries and selection tools without leaving
your MagiCAD project. You can insert BIM objects from MagiCAD Cloud directly into your project and
use selection tools to select, configure and insert manufacturer products.
MagiCAD Create offers a fast and easy way to create custom MEP-specific BIM objects and libraries.
MagiCAD Builders Work Openings Tool is a utility for managing provisions for voids (builders work
openings).
Installing is easy, just check the tools you want to install and click Next.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
9 (19)

It is important that you save your work and close Revit before continuing.
Click Install to continue. The MagiCAD Setup will then begin copying files and defining the necessary
settings.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
10 (19)

Click Finish to complete the setup.

When the MagiCAD Setup procedure has been completed, check that the program license is
available. Follow the instructions for license usage and activation in the chapter ”Licensing”.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
11 (19)

HOW TO CHECK THE INSTALLED MAGICAD RELEASE VERSION

The Comments column in Programs and Features displays the version, e.g. MagiCAD Release: 2024.

If the Comments column in Programs and Features is not visible, right-click the column title bar, select
’More...’, select ’Comments’ and click ’OK’.

LICENSING

MagiCAD can be used with two types of licenses:

Stand-alone licenses, which are activated for a specific workstation. Internet connection is required
when the licenses are activated. However, when the licenses have been activated, the program can be
used also when disconnected from the network.

Network licenses, which are stored on a network server.

If your company’s IT administrator has enabled license borrowing, you can borrow the application
licenses to be used while disconnected from the network.
Setting up a network license server is described in a separate document.

Both license types are managed at the workstation using the license management utility. The shortcut
link to the utility can be found in the MagiCAD\ Tools desktop folder.

If the version of the MagiCAD license currently activated on your workstation is 2015.11 SR-1 or
older, you need to return the old license before you can activate the new license.

Select the product and click the Return button.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
12 (19)

PROGRAM DIRECTORY STRUCTURE


The program executables are mainly installed to the Destination Folder selected during the MagiCAD
Setup procedure.

EXECUTABLE FILES

The files of the MagiCAD Supports & Hangers application are installed under one of the following
directories, depending on the Revit platform:

C:\Program Files\MagiCAD Group\MagiCAD Supports & Hangers\r2021


C:\Program Files\MagiCAD Group\MagiCAD Supports & Hangers\r2022
C:\Program Files\MagiCAD Group\MagiCAD Supports & Hangers\r2023
C:\Program Files\MagiCAD Group\MagiCAD Supports & Hangers\r2024

The utilities that are shared by MagiCAD for Revit and MagiCAD for AutoCAD are installed in the
following directories:

C:\Program Files\Common Files\MagiCAD Common\Check for Updates


C:\Program Files\Common Files\MagiCAD Common\License Management Utility

LOCATION OF FILES THAT CAN BE MODIFIED AT RUNTIME


By default, the location of the user-modifiable files is in the “local application folder”. It is, however,
possible to affect the search path of these files when the software is installed as silent setup (see
chapter “Utilising MSI properties”.

The default location is one of the following, depending on the Revit platform:

C:\ProgramData\MagiCAD-RS\2024_r2021
C:\ProgramData\MagiCAD-RS\2024_r2022
C:\ProgramData\MagiCAD-RS\2024_r2023
C:\ProgramData\MagiCAD-RS\2024_r2024

Subdirectory Contents
Documentation User’s Guide and “Read Me First”
Mrv Datasets
Annotations Text tags
Templates Templates for MagiCAD for Revit

Please do not modify the contents of other subdirectories, nor the file magiParameters.txt.

The data files of MagiCAD Supports & Hangers are installed under one of the following directories,
depending on the Revit platform:

C:\ProgramData\MagiCAD Group\MagiCAD Supports & Hangers\r2021


C:\ProgramData\MagiCAD Group\MagiCAD Supports & Hangers\r2022
C:\ProgramData\MagiCAD Group\MagiCAD Supports & Hangers\r2023
C:\ProgramData\MagiCAD Group\MagiCAD Supports & Hangers\r2024

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
13 (19)

STARTING THE PROGRAM


The program will start automatically when you start Revit. The default template to be used with
MagiCAD for Revit will also be loaded automatically.

The ”MagiCAD for Revit” folder does not include a shortcut icon for starting the program. Start Revit
normally using its shortcut.

MagiCAD commands are found under “MagiCAD Common”, ”MagiCAD Ventilation”, “MagiCAD Piping”,
and “MagiCAD Electrical” ribbon tabs.

MagiCAD Plugin Manager and MagiCAD Supports & Hangers are also loaded automatically when you
start Revit.

MAGICAD PLUGIN MANAGER

When you start the program for the first time, MagiCAD Plugin Manager window opens and you can
install third-party plugins to complement your software. You can also start the plugin manager later from
the MagiCAD ribbon.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
14 (19)

CHECKING FOR UPDATES


You need an open internet connection to be able to use this function.
When you click the Check for Updates button in the MagiCAD Common ribbon, a utility displaying the
available updates starts.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
15 (19)

INSTALLING MAGICAD ON MULTIPLE WORKSTATIONS


MSI INSTALLATION PACKAGE
The MagiCAD Setup procedure is performed using Microsoft Installer technology. The installation can
be customised with the help of certain properties, which reduces the amount of work when a large
number of workstations are configured.
The properties can be manipulated, e.g., by employing scripts or transforms.
If the program is installed using a silent setup, it is possible to manipulate two directory settings. If the
MSI property is not specified, default value is used.

Property Purpose Default value


INSTALLDIR The directory where the program C:\Program Files\MagiCAD for
executables will be installed. Revit\2024_r2024
Note: this may vary depending on the
language of the operating system and
the program version
DIR_LOCALDATA The directory where the user- C:\ProgramData\MagiCAD for
modifiable files will be located Revit\2024_r2024
Note: this may vary depending on the
language of the operating system and
the program version

DIR_2DSYMBOLS The directory where the 2Dsymbol C:\ProgramData\MagiCAD for


files will be located. Revit\2024_r2024
Note: this may vary depending on the
language of the operating system and
the program version

DIR_PRODUCTS The directory where the product files C:\ProgramData\MagiCAD for


will be located. Revit\2024_r2024
Note: this may vary depending on the
language of the operating system and
the program version

DIR_CONFIGURATIONS The directory where the C:\ProgramData\MagiCAD for


configuration files will be located. Revit\2024_r2024
Note: this may vary depending on the
language of the operating system and
the program version

UI_LANGUAGE User interface language of the 1512


program.
1512=English
1513=German
1515=French
1516=Spanish
1517=Italian
1528=Russian
1539=Chinese

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
16 (19)

Property Purpose Default value


LICENSE_SERVER Server(s) containing network
licenses defined in port@host
format. Multiple servers are
separated with a semicolon.
INSTALL_CFU Install Check for Updates 1
0=no, 1=yes
INSTALL_LMU Install License Management Utility 1
0=no, 1=yes
INSTALL_PM Install Plugin Manager 1
0=no, 1=yes

Note that the DIR_LOCALDATA, DIR_2DSYMBOLS, DIR_PRODUCTS and DIR_CONFIGURATIONS


properties affects only the search path that is written to the program registry. The directory specification
is provided in case you want the program to search the files from a different directory (e.g. a shared
network directory).
The setup program still copies the files to the default directory on the workstation.

Sample installation batch files

When installing MagiCAD with MSI package, place all .MST files in the same folder as the .MSI
installation package.

This sample batch installs the 64-bit Revit 2024 compatible version of MagiCAD to the directory
C:\MC_Revit_2024_r2024 and writes the registry so that the data files are read/written in directory
X:\MC_Revit_LocalData.

The user interface language is English (default language) and the license server is not specified.
msiexec /i "MagiCAD 2024 for Revit 2024.msi" /qn
INSTALLDIR="C:\MC_Revit_2024_r2024" DIR_LOCALDATA="X:\MC_Revit_LocalData"

This sample batch installs the 64-bit Revit 2021 compatible version of MagiCAD to the default directory.
User interface language is selected to be Chinese and the program uses network licenses that are
located on server1 (no port number specified). Default paths are used.
msiexec /i "MagiCAD 2024 for Revit 2021.msi" /qn UI_LANGUAGE=1539
LICENSE_SERVER="@server1"

Data, 2Dsymbol, Products, and Configurations folders are defined to different locations.
msiexec /i "MagiCAD 2024 for Revit 2024.msi" /qn
DIR_LOCALDATA="X:\MC_Revit_LocalData" DIR_2DSYMBOLS="Y:\MC\2Dsymbols"
DIR_PRODUCTS="Y:\MC\Products" DIR_CONFIGURATIONS="Y:\MC\Configs"

Setup packages for additional tools are delivered together with the MagiCAD installer. It is optional, but
recommended to install the following applications: MagiCAD Connect, MagiCAD Create, MagiCAD
Builders Work Openings

msiexec /i "MagiCAD Connect for Revit 2024.msi" /qn


msiexec /i "MagiCAD Create.msi" /qn
msiexec /i "MagiCAD Builders work openings tool r2024.msi" /qn

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
17 (19)

EXE INSTALLATION PACKAGE

Properties for installing MagiCAD 2024 for Revit.exe using command line are limited to UI language and
installation location.

Property Purpose Default value

InstallFolder The directory where the program will C:\Program Files\MagiCAD for
be installed. Revit\2024_r2024
Note: may vary depending on the
language of the operating system
Language User interface language of the 1512
program.
1512=English
1513=German
1515=French
1516=Spanish
1517=Italian
1528=Russian
1539=Chinese

Sample installation batch files for exe package

Silent installation to default location with English UI language:

"MagiCAD 2024 for Revit 2024.exe" /silent

Silent installation, German UI language, custom location:

"MagiCAD 2024 for Revit 2024.exe" /silent /Language=1513


/InstallFolder="C:\Program Files\MagiCAD for Revit 2024"

Silent installation of patch package

There are no parameters for patch packages, but you can install them silently:

"MagiCAD 2024 UR-1 for Revit 2024 - patch.exe" /silent

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
18 (19)

FREQUENTLY ASKED QUESTIONS


WHY DOES THE INSTALLER DISPLAY THE WARNING ”REVIT IS NOT FOUND”?
There are four installer packages: MagiCAD for Revit 2021, MagiCAD for Revit 2022, MagiCAD for
Revit 2023.1 and MagiCAD for Revit 2024. If you are trying to install the wrong version of MagiCAD, the
installer displays the following warning:

WHY DO I GET SCHNEIDERELECTRIC SERVICE POPUP DURING INSTALLATION?


Schneider Electric Ecodial Engine is already installed with previous MagiCAD installation. Select
”Automatically close...” and click OK to continue.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]
19 (19)

SCHNEIDER ELECTRIC ECODIAL PLUGIN FOR AUTOCAD DETECTED, WHAT SHOULD I DO?
If you need MagiCAD’s electrical calculations, check ”Install Ecodial service anyway”. After the
installation, Ecodial Plugin for AutoCAD may not function anymore.

WAS THE PATCH INSTALLED SUCCESSFULLY? I CANNOT FIND IT IN PROGRAMS AND FEATURES
(INSTALLED APPS IN WINDOWS 11).
After patch installation, the MagiCAD name in Programs and Features remains the same, but the
Version Number is updated. MagiCAD 2024 Main Release version number begins with 24.0, UR-1 with
24.1 and UR-2 with 24.2.

HOW CAN I UNINSTALL A PATCH?


You cannot uninstall only the patch installation. Uninstalling MagiCAD from Programs and Features will
uninstall MagiCAD entirely.

MagiCAD Group, Aurakatu 8, 20100 Turku, Finland | Tel. +358 2 8387 6000 | www.magicad.com | [email protected]

You might also like