MindStudio Installation

Prerequisites

• Preparing Software Packages to Installing Dependencies have been completed.
• You have installed the Ascend-CANN-Toolkit by following instructions in the CANN Software Installation Guide.

Procedure

1. Upload the software package to the target environment as the MindStudio installation user.
2. Extract the MindStudio tar.gz package.

   Run the following command as the MindStudio installation user to extract the MindStudio_{version}_linux.tar.gz package:

   tar -zxvf MindStudio_{version}_linux.tar.gz

   For details about the content extracted from the package, see Table 1.

3. As the MindStudio installation user, go to the MindStudio/bin directory generated after package extraction and start MindStudio.

   cd MindStudio/bin
   ./MindStudio.sh

   

   • If the error message "Failed to initialize graphics environment", "Unable to detect graphics environment", or "Can't connect to X11 window server using 'localhost:xxx' as the value of the DISPLAY variable" is displayed when MindStudio is started, rectify the fault by referring to What Do I Do If the GUI Cannot Be Displayed When MindStudio Is Started?.
   • If the message "WARNING: Install the haveged service by referring to the installation guide." is displayed when MindStudio is started, rectify the fault by referring to What Do I Do If I Get Error "WARNING: Install the haveged service by referring to the installation guide" When Starting MindStudio?.
   • If the system displays a message indicating that the libXext.so.6 file cannot be found when MindStudio is started on EulerOS 2.10, rectify the fault by referring to What Do I Do If I Get Error "java.lang.UnsatisfiedLinkError: /home/username/MindStudio/jbr/lib/libawt_xawt.so" When Starting MindStudio?.
   • If the system displays a message indicating that no sufficient space can be reserved for the object heap when MindStudio is started, rectify the fault by referring to What Do I Do If MindStudio Cannot Be Started When the Set Memory Is too Large?.
   • To specify the MindStudio operating environment, create the mindstudio.jdk file in the $HOME/.config/Huawei/MindStudioMS-{version} directory and write the JBR or JDK installation directory of the user into the file.
     Figure 1 mindstudio.jdk (example)
     

MindStudio Configuration

1. Open the settings import dialog box, as shown in Figure 2.
   Figure 2 Environment settings
   
   • Config or installation director: imports MindStudio settings from an existing directory.

     The directory is $HOME/.config/Huawei/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 2 when you are installing a later version. You can choose whether to import the settings from the earlier version as required.
   • If this version of MindStudio has been installed on the server earlier, and the $HOME/.cache/Huawei/MindStudioMS-{version} and $HOME/.config/Huawei/MindStudioMS-{version} directories have not been deleted during the uninstallation, you will be directed to 2 from 1 when you try to install this version again.

2. If no error is reported and the welcome page is displayed, MindStudio is successfully installed.
   Figure 3 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)

   

   Find the following new directories in $HOME on the MindStudio installation server:

   • $HOME/.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.
   • $HOME/.cache/Huawei/MindStudioMS-{version}: stores run logs (log/idea.log) generated after MindStudio is installed and launched.
   • $HOME/.config/Huawei/MindStudioMS-{version}: stores user configuration, 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 project, as shown in Figure 4, you need to configure the Ascend-CANN-Toolkit installation path, click Change, go to 4, and perform subsequent operations as prompt.
     Figure 4 Creating an Ascend operator project (example)
     
   • On the Projects tab page, click Open to open an existing project. A dialog box shown in Figure 5 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 5 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 6 is displayed. Click OK.

     Figure 6 CANN package not installed
     

     The window shown in Figure 7 is displayed. Click the Change button and go to 4.

     Figure 7 Modifying the properties of the operator 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 $HOME/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. Display the page shown in Figure 8.
   

   If the page is not completely displayed, rectify the fault by following the instructions in How Do I Solve the Problem that Chinese Characters Are Displayed as Garbled Characters and the GUI Is Incompletely Displayed or Is Not Well-Organized?.

   Figure 8 Selecting the Ascend-CANN-Toolkit path
   

   The versions of the Ascend-CANN-Toolkit installed by the installation user in the default path are automatically added to CANN-Toolkit Version. You can directly select the required version and click Finish.

   

   Default paths of the Ascend-CANN-Toolkit are as follows:

   • root user: /usr/local/Ascend/ascend-toolkit
   • Non-root user: ${HOME}/Ascend/ascend-toolkit

     In the preceding paths, ${HOME} indicates the directory of the current user.

   To select another installed version, click next to CANN-Toolkit Path. In the dialog box displayed, select the installation path of the Ascend-CANN-Toolkit (including the version number x.x.x or to the latest level). Click OK. The selected Ascend-CANN-Toolkit version information is displayed in CANN-Toolkit Version. Then click Finish.

5. Optional: Enter the MindStudio page and choose File > Settings > Plugins to search for and install the following plugin tools:
   • Grep Console
   • Pylint
   

   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.