Skip to content

Commit e36118c

Browse files
author
Jonathan Diehl
committed
Add Parallels connection troubleshooting to mobile prerequisites
Surface the Mac IP vs Windows VM IP gotcha and port forwarding requirement directly in the Make It Native troubleshooting section, instead of only linking out to Configuring Parallels. Applied to Studio Pro 11, 10, and 9 refguides.
1 parent 0c95cf3 commit e36118c

3 files changed

Lines changed: 15 additions & 0 deletions

File tree

content/en/docs/refguide/mobile/getting-started-with-mobile/prerequisites.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,11 @@ The latest version of Make It Native 9 is only compatible with versions of Mendi
163163
164164
To use Studio Pro on a Mac device, you will first need to install and configure Parallels. For more information, see [Configuring Parallels](/refguide/using-mendix-studio-pro-on-a-mac/).
165165
166+
If the Make It Native app cannot connect when you use Parallels, check the following:
167+
168+
* Enter your Mac's IP address in the Make It Native app's **Host** field, not the IP address of the Windows virtual machine that Studio Pro shows. For instructions on finding your Mac's IP address, see the [Viewing Your App on Your Testing Device](/refguide/using-mendix-studio-pro-on-a-mac/#viewing-your-app-on-your-testing-device) section of *Configuring Parallels*.
169+
* Make sure port forwarding is enabled for ports 8080, 8083, and 8100 in your Parallels network preferences. For setup steps, see the [Configuring Your Windows Virtual Machine for Mendix Studio Pro](/refguide/using-mendix-studio-pro-on-a-mac/#configuring) section of *Configuring Parallels*.
170+
166171
### Avoid Network or Cloud Folders
167172
168173
Storing a Mendix project on a network drive or in a cloud folder (such as those provided by OneDrive or Dropbox) is **not recommended**. Storing your projects in such folders will significantly slow down Studio Pro and cause errors when trying to run projects containing a native mobile profile. Note also that projects with a native mobile profile can only be started from drive **C:**.

content/en/docs/refguide10/mobile/getting-started-with-mobile/prerequisites.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,11 @@ The latest version of Make It Native 9 is only compatible with versions of Mendi
144144
145145
To use Studio Pro on a Mac device, you will first need to install and configure Parallels. For more information, see [Configuring Parallels](/refguide10/using-mendix-studio-pro-on-a-mac/).
146146
147+
If the Make It Native app cannot connect when you use Parallels, check the following:
148+
149+
* Enter your Mac's IP address in the Make It Native app's **Host** field, not the IP address of the Windows virtual machine that Studio Pro shows. For instructions on finding your Mac's IP address, see the [Viewing Your App on Your Testing Device](/refguide10/using-mendix-studio-pro-on-a-mac/#viewing-your-app-on-your-testing-device) section of *Configuring Parallels*.
150+
* Make sure port forwarding is enabled for ports 8080, 8083, and 8100 in your Parallels network preferences. For setup steps, see the [Configuring Your Windows Virtual Machine for Mendix Studio Pro](/refguide10/using-mendix-studio-pro-on-a-mac/#configuring) section of *Configuring Parallels*.
151+
147152
### Avoid Network or Cloud Folders
148153
149154
Storing a Mendix project on a network drive or in a cloud folder (such as those provided by OneDrive or Dropbox) is **not recommended**. Storing your projects in such folders will significantly slow down Studio Pro and cause errors when trying to run projects containing a native mobile profile. Note also that projects with a native mobile profile can only be started from drive **C:**.

content/en/docs/refguide9/mobile/getting-started-with-mobile/prerequisites.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,3 +130,8 @@ The latest version of Make It Native 9 is only compatible with versions of Mendi
130130
### Configure Parallels
131131
132132
To use Studio Pro on a Mac device, you will first need to install and configure Parallels. For more information, see [Configuring Parallels](/refguide9/using-mendix-studio-pro-on-a-mac/).
133+
134+
If the Make It Native app cannot connect when you use Parallels, check the following:
135+
136+
* Enter your Mac's IP address in the Make It Native app's **Host** field, not the IP address of the Windows virtual machine that Studio Pro shows. For instructions on finding your Mac's IP address, see the [Viewing Your App on Your Testing Device](/refguide9/using-mendix-studio-pro-on-a-mac/#viewing-your-app-on-your-testing-device) section of *Configuring Parallels*.
137+
* Make sure port forwarding is enabled for ports 8080, 8083, and 8100 in your Parallels network preferences. For setup steps, see the [Configuring Your Windows Virtual Machine for Mendix Studio Pro](/refguide9/using-mendix-studio-pro-on-a-mac/#configuring-your-windows-virtual-machine-for-mendix-studio-pro) section of *Configuring Parallels*.

0 commit comments

Comments
 (0)