MindStudio Installation

Prerequisites

Prepare for MindStudio installation. See Environment Requirements to Installing Dependencies.

Procedure

1. Double-click MindStudio_{version}_win.exe to install MindStudio.
   • To install MindStudio using MindStudio_{version}_win.exe and record the installation steps, run the following command in the cmd.exe command line:

     .\MindStudio_{version}_win.exe /LOG=D:\log\install.log
     # D:\log\install.log is an example of the installation log path. Set the absolute path and name of the installation log file as required.

     

     If the log parameter /LOG is not set as required, the installation process log file will not be generated, but the program installation is not affected.

   • To install MindStudio using MindStudio_{version}_win.zip, skip steps 1 to 9. Instead, double-click MindStudio64.exe in the bin directory generated after the decompression, and directly configure MindStudio.
2. On the MindStudio Setup page, click Next, as shown in Figure 1.
   Figure 1 MindStudio setup
   
3. (Optional) If MindStudio is not installed for the first time, you can determine whether to uninstall the earlier version.
   • If you do not uninstall the existing version, click Next to go to 5.
   • If you want to uninstall the existing version, select the version, select Uninstall silently, and click Next to go to 4.
     Figure 2 Uninstalling the earlier version
     
4. (Optional) Select the options to be uninstalled and click Uninstall. After the uninstallation is complete, click Close.
   Figure 3 Uninstalling MindStudio
   
5. Select the MindStudio installation path and click Next. See Figure 4.
   Figure 4 MindStudio installation path
   
   

   You are advised to install MindStudio in the C:\ProgramFiles directory. If you install MindStudio in another directory, cancel the modification permission of common users to prevent other users from modifying the running files.

6. Select installation options as required and click Next. See Figure 5.
   Figure 5 Selecting installation options
   
   • Create Desktop Shortcut: selects MindStudio and creates a desktop shortcut.
   • Update PATH Variable(restart needed): adds the path of the MindStudio boot file to the environment variable PATH so that MindStudio can be started directly from the system command line. If this option is selected, you need to restart the OS after MindStudio has been installed and configured.
   • Update Context Menu: Select Add "Open Folder as Project" and right-click the folder to open it as a MindStudio project.
   • Create Associations: By default, this option is not selected.
7. Select or create the start menu folder in the MindStudio installation path, and click Install. See Figure 6.
   Figure 6 Start Menu Folder
   
8. Start to install MindStudio. After the installation is complete, click Next. See Figure 7.
   Figure 7 Installing
   
9. After MindStudio is installed and configured, click Finish, as shown in Figure 8.
   Figure 8 Completing MindStudio Setup
   

MindStudio Configuration

1. Go to the bin folder in the MindStudio installation directory, and double-click the MindStudio application to start MindStudio. The page for importing settings is displayed, as shown in Figure 9.
   Figure 9 Environment settings
   
   • Config or installation director: imports MindStudio settings from an existing directory.

     The directory is C:\Users\individual user\AppData\Roaming\MindStudioMS-{version}. The MindStudio settings include the personalized settings of the project UI such as the background color.

   • Do not import settings (default): creates a configuration file.

   Select an option and click OK.

   

   • If an earlier MindStudio installation is detected, the Previous version parameter is displayed in the dialog box shown in Figure 9 when you are installing a later version. You can choose whether to import the settings from the earlier version as required.
   • If MindStudio of the same version is detected and the C:\Users\individual user\AppData\Roaming\Huawei\MindStudioMS-{version} and C:\Users\individual user\.mindstudio directories are not deleted when you uninstall the previous version, the re-installation proceeds to 4 from 1.
2. If no error is reported and the welcome page is displayed, MindStudio is successfully installed. See Figure 10.
   Figure 10 Welcome page
   

   Table 1 Parameters

   Parameter	Description
   Projects tab page (project management)
   New Project	Create a project.
   Open	Open an existing project.
   Get from VCS	Use the version control tool to download the code repository and open it.
   Customize tab page (settings customization)
   Color theme	Set the color theme.
   Accessibility	Set auxiliary functions, including setting the IDE font size and adjusting the colors for users with red and green visual defects.
   Keymap	Set keyboard mapping. MindStudio automatically recommends a predefined keyboard mapping based on your environment. Ensure that it matches the OS you are using. Alternatively, you can manually select an OS that matches the shortcuts in another IDE or editor that you are accustomed to.
   Import Settings...	Import personalized MindStudio settings from the customized configuration directory.
   All Settings...	Switch to the Settings page.
   Plugins tab page (plugin management)
   Marketplace	Search for and download required plugins from the plugin market.
   Installed	Check the installed plugins.
   Learn MindStudio tab page (MindStudio help)

   

   After the installation is successful, the following directories are created on the local Windows host:

   • C:\Users\individual_user\.mindstudio: stores the MindStudio property file mindstudio.properties (recording the Toolkit installation path) and records of operations performed by users on the privacy statement window.
   • C:\Users\individual_user\AppData\Local\Huawei\MindStudioMS-{version}: stores run logs generated during MindStudio installation and after startup.
   • C:\Users\individual_user\AppData\Roaming\Huawei\MindStudioMS-{version}: stores user configurations, including personalized settings (such as the background color) of the project UI.
3. Create a project or open an existing project.
   • On the Projects tab page, click New Project to create a project. If the new project is an Ascend operator project, as shown in Figure 11, you need to configure the Ascend-CANN-Toolkit installation path, click Change, go to step 6, and perform subsequent operations as prompt.
     Figure 11 Creating an Ascend operator project (example)
     
   • On the Projects tab page, click Open to open an existing Ascend project. A dialog box shown in Figure 12 is displayed, indicating that the functions provided by MindStudio may execute potential malicious code in the project. In this case, confirm the code before opening the project.
     Figure 12 Trust configuration window
     

     • Trust projects in {directory where the project is located}: Trust all projects in the directory where this project is located .
     • Trust Project: Trust this project.
     • Preview in Safe Mode: Preview the project in safe mode.
     • Don't Open: Do not open the project.
     If the opened project is an Ascend project (using an application project as an example), a dialog box shown in Figure 13 is displayed. Click OK.

     Figure 13 CANN package not installed
     

     The window shown in Figure 14 is displayed. Click the Change button and go to 6.

     Figure 14 Modifying the properties of the application project (example)
     
   

   For details about the parameters for creating a project from New Project or opening an existing project from Open, see "Project Management > Project Creation > Ascend Projects/Non-Ascend Projects" in the MindStudio User Guide.

   On the Projects tab page, click Get from VCS. On the version management page displayed, configure the URL of the Git repository and click Clone to download (stored in C:\Users\individual_user\MindstudioProjects by default) and open the project.

   The process of opening an Ascend project downloaded from the version management page is the same as the process of opening an existing Ascend project by clicking Open on the Projects tab page.

4. On the page shown in Figure 15, click to connect the Windows environment where MindStudio is located to the remote development environment where Ascend-CANN-Toolkit is located. Click next to Remote CANN location. In the dialog box displayed, select the installation path of the Ascend-CANN-Toolkit (including the version number).
   Figure 15 Connecting to the remote CANN
   
5. On the page for configuring the SSH connection, click to configure the SSH connection parameters. Click OK, as shown in Figure 16.
   Figure 16 SSH configuration
   

   Table 2 Parameters and icons

   Parameter/Icon	Description
   Host	Destination address of the connection (IP address or domain name)
   Port	Port number of the destination address of the connection.
   User name	Username for logging in to the destination address.
   Authentication type	Authentication method. Two methods are available: Password: Enter a password for authentication. Key pair: Use an SSH key for authentication. Prepare the key in advance by yourself. NOTE: In the EulerOS 2.8/2.10 AArch architecture, Kylin OS V10 SP1 AArch architecture, openEuler, Ubuntu 20.04, and CentOS 8.2, when Key pair is used for identity authentication, you need to run the ssh-keygen -m PEM or ssh-keygen -t rsa -m PEM command to apply for an SSH key. When applying for an SSH key, you are advised to set Passphrase to a value that meets the following password complexity requirements: The password is at least eight characters long. It must contain at least two types of the following characters: At least one lowercase letter At least one uppercase letter At least one digit Special characters: `~!@#$%^&*()-_=+\|[{}];:'",<.>/? and spaces If you select Key pair, the configured private key file is saved by default.
   Password	Available when Authentication type is set to Password. Enter the correct password. You can select Save password to save the password. NOTE: If Save password is not selected, the password will be automatically cleared after 24 hours. When you use SSH next time, the password text box is displayed. You need to enter the password again to execute the SSH task.
   Private key file	Available when Authentication type is set to Key pair. Select a local private key file.
   Passphrase	Available when Authentication type is set to Key pair. Enter the correct passphrase. You can select Save password to save the passphrase.
   Test Connection	Checks whether the connection is successful.
   	Adds a new SSH connection.
   	Deletes an SSH connection. Select an SSH connection to be deleted and click this icon.
   Lock the current connection	The option is dimmed and cannot be operated. If an SSH connection is added to the cluster management, this option is automatically selected. In this case, the SSH connection is locked and cannot be modified and deleted.

6. Enter the Ascend-CANN-Toolkit installation path in the remote environment. See Figure 17.
   Figure 17 Ascend-CANN-Toolkit installation path
   
7. Enter MindStudio and choose File > Settings > Plugins to search for the following plugin tools in the plugin market and install them:
   • Grep Console
   • Pylint
   

   • If MindStudio fails to be started, rectify the fault by referring to What Do I Do If MindStudio Cannot Be Started When the Set Memory Is too Large?.
   • If the system displays a message indicating that the network is disconnected or the plugin does not exist when you search for a plugin tool, rectify the fault by referring to What Do I Do If a Message Is Displayed Indicating that the Network Is Disconnected or the Plugin Does Not Exist When I Install a Plugin in MindStudio.
   • To specify the MindStudio operating environment, create the MindStudio64.exe.jdk file in the C:\Users\Individual user\AppData\Roaming\Huawei\MindStudioMS-{version}\ directory and write the JBR or JDK installation directory into the file.
     Figure 18 MindStudio64.exe.jdk (example)