DevMagic Studio Installation Guide
Last updated: June 2023
DevMagic Studio Installer is an online installer that automatically downloads and decompresses installation files. During installation, your machine must be connected to the Internet. If you need an offline installer, you can download it from the DevMagic Studio Installer.
No license is required to use the beta version, but you need to log in with your DevMagic cloud account when opening the DevMagic Studio IDE. If you do not have a DevMagic cloud account, you can register one when you log in to the IDE.
Environment preparation
Before installing DevMagic Studio Beta version, prepare your environment.
System Requirements
Please make sure your system meets the following requirements.
Processor | Memory | Hard Drive | Operating System |
---|---|---|---|
Type: Intel or AMD Cores: 4 (8 plus recommended) Speed: 1.8 GHz or faster |
8 GB (16 GB recommended) | Minimum 4 GB (depending on features installed) | Windows 11 version 21H2 or higher Windows 10 version 20H2 or higher Windows Server 2022: Standard and Datacenter Windows Server 2019: Standard and Datacenter Windows Server 2016: Standard and Datacenter (DevMagic Studio has no special requirements for the minor version number of the operating system, as long as it's within the valid support period.) |
The processor must be Wintel compliant; which means only Intel or AMD processor is supported (ARM and other processors are NOT supported).
The hard disk space requirement is an estimated value. The actual disk space required for each product may vary based on hard drive size, partitions, and features you choose to install. Additional temporary hard disk space is required to extract the installation files during installation.
Database Server Requirements
The DevMagic Studio IDE can connect to the following database types and versions.
Database Type | Database Version |
---|---|
MySQL Amazon RDS for MySQL Amazon Aurora for MySQL Azure Database for MySQL |
5.6, 5.7, or 8.0 8.0.20 5.6.10a 5.6 |
Oracle Amazon RDS for Oracle |
12c, 18c, or 19c 12.1.0.1 |
PostgreSQL Amazon RDS for PostgreSQL Amazon Aurora for PostgreSQL Azure Database for PostgreSQL |
9.6, 10.1, 11.3, or 12 12.3-R 11.6 11 |
SQL Server Amazon RDS for SQL Server Azure SQL Database |
2017, 2019, or 2022 2017 14.00.3281.6.v1 Latest SQL Server Engine (as of September 2020 ) |
SQLite | 3 |
Installation preparation
Before installation, please confirm that the following tasks have been completed:
Log in to Windows as an administrator, as you must have administrator rights to run the installer.
Read the release bulletin for the latest information on products being installed. The release bulletin is available at: https://docs.devmagic.com/devmagicstudio/release_bulletin/index.html.
Make sure you have a TEMP environment variable that points to a directory location with at least 2GB of free space. The installer writes files to this directory during the installation process and frees up space after the installation is complete.
Online installation
Step 1: Run the DevMagic Studio Installer (you must have administrator rights to run the installer).
Step 2: Select the checkbox to agree to the license terms and click Continue.
Step 3: On the installer main page, click the Install button in the DevMagic Studio 2023 Beta version.
If you already have DevMagic Studio installed, you will see the following options:
Modify -- Modify the selected workloads, components, or installation path.
Launch -- Launch the installed DevMagic Studio.
Update -- Upgrade DevMagic Studio to the latest version. If the latest version has already been installed, this option will not display.
More -- Provides more options such as downloading offline packages, uninstalling DevMagic Studio.
Step 4: Select the project types, dependencies, and features to install in the Workloads & components tab.
When installing DevMagic Studio Beta, the workloads/components required for rapidly creating entities for EF Core are automatically selected for installation. For example, some items under the Designer-developed projects, Environment dependency, Database support and Test platform categories are automatically selected.
The SQLite database support and SQL Server database support are selected for installation by default.
Besides SQLite and SQL Server, you can also select to install support files for MySQL, Oracle, and PostgreSQL.
Step 5: In the Installation locations tab, specify the location where you want to download and install the product.
You can select the option Keep the download cache after the installation if the downloaded file will be used in another installation. It is unchecked by default to ensure that downloaded files will be removed to free up the disk space.
Step 6: Click Install to start the installation.
Step 7: After the installation is complete, read the status messages carefully to ensure that the installation was successful.
After successful installation, you can directly click the Launch button on the installer to start DevMagic Studio. Or start DevMagic Studio from the Windows Start menu.
Offline installation
Offline installation helps users install the product on the machine where Internet connection is not available.
Downloading Offline Installer
The offline installer can be downloaded from the DevMagic Studio Installer. Launch the DevMagic Studio Installer, select Download offline packages from the More option list, and then select the workloads or components to download (by default all available workloads and components are selected).
When the download is complete, click Open Folder (the default folder is C:\ProgramData\DevMagic Studio\EN) to get the standalone installation package (the offline installer). Now you can distribute the offline installer to any computer to install the product.
Starting Offline Installer
To launch the downloaded offline installer:
Step 1: Exit any programs that are running.
Step 2: Run the Installer.exe file in the offline package (you must have administrator privileges to run the installer).
The installation options and process are exactly the same as the online installation.
Activating DevMagic Studio
Beta version does not require activation. But you need to use your DevMagic cloud account to log in when you open DevMagic Studio IDE. If you do not have a DevMagic cloud account, you can register one when you log in to the IDE.
Uninstalling DevMagic Studio
If you plan to reinstall, first back up files that may be reused later (e.g. databases, source code files).
Uninstall the product by:
Opening the Control Panel from the Start menu and double-click the Add/Remove Programs button. In the Install/Uninstall page, select DevMagic Studio.
Running the DevMagic Studio Installer. Select Uninstall from the More drop-down list.