How to Connect to Avionté - Hosted Customers (Mac)

There are several ways for hosted customers to connect to Avionté, allowing for different systems and configurations.  While the majority of these will be the same in both Windows and Mac systems, the remote desktop connection portion will be different for Mac users. 

To see the other non-Remote Desktop Steps, please see our article on them here:

• How to Connect to Avionté - Hosted Customers (Windows)

Key Takeaways

• Download Remote Desktop for Mac
• Login to Remote Desktop
• Troubleshooting Remote Desktop
  
  

CHAPTERS:

Remote Desktop

Folder Redirection

Troubleshooting

Remote Desktop

Connect to Core Application with Microsoft Remote Desktop for Mac

The Avionté Suite application is a Microsoft-based application, but it can be accessed with the Microsoft Remote Desktop application even when using a different operating system, such as macOS. 

Note: Ensure your remote desktop application is the one most recently available.

• Click here to download Microsoft Remote Desktop 10 (Version 10.7.7; Jun 27, 2022).
  • Click on View in Mac App Store. The Mac App Store appears with Microsoft Remote Desktop shown.

1. Install the latest version of Microsoft Remote Desktop from the Mac App Store by clicking on the download arrow.
   
   

   

2. After the download successfully completes, open Safari.
   
   
3. Enter the link to the Avionté application with your unique, three- or four-character company code inserted into the browser. 
   Example: https://ABC-mac.aviontego.com. Safari will search for the workspace. If it finds one, it will display the Avionté Application Portal.
   
   
   
   
4. Enter your Username and Password.
   1. AVIONTEGO\user.name (change "user.name" to your username)
      Note: [e-mail] also works.
      
      
5. Click on Sign In once credentials are entered correctly.
   1. The RemoteApp and Desktops screen appears.
      
      
      
      
6. Click the Avionté icon. A download will occur, popping up in the right-hand bottom corner.
   
   
   
   
7. Open the Microsoft Remote Desktop app.
8. Click on the PCs tab at the top
9. Click on the three dots icon
   
   
   
10. Click on Import from RDP file...
    
    
    
    
11. A Downloads screen displays.
    
    
    
12. Note the name of the download so you will recognize it. (Your download name will be different from what is in the screenshot.) Import the RDP file that was just downloaded.
    1. The RDP connection appears in the PCs tab.
13. Hover over it then click the pencil icon to edit the RDP connection info.
14. In the Edit PC window, click on the Gateway dropdown and select Add Gateway...
15. In the Add a Gateway window, clear out everything in the Gateway name box
    1. Type the following into the Gateway name: [ABC]-mac.aviontego.com (where [ABC] is the client abbreviation) 
16. Click the User account dropdown and select Add User Account...
17. Enter the user account and password used to log in earlier. Click Add.
18. Click the blue Add button on the gateway information, and Save on the Edit PC window.
19. Now double-click the saved RDP connection in the PCs tab and Classic should launch.
20. If a pop-up opens asking for user credentials, use the same password as on the portal, and the same username but with @aviontego at the end.
    
    
    
    
    
    
    

Enable Folder Redirection when desired

1. Select Microsoft Remote Desktop from the upper left of the Mac screen. 
   
   
   
   
2. Select Preferences. The Preferences screen displays.
   
   
   
   
3. Select Choose Folder from the "If folder redirection is enabled for Feeds or RDP files, redirect:" option
   
   
   
   
4. Select the folder(s) or drive(s) to which the system should redirect.
   
   
5. Click Choose. The updated redirect will take effect at computer restart. 

Troubleshooting

No Applications Available in the Microsoft Remote Desktop Application Window

If the Microsoft Remote Desktop application is not able to communicate with the Avionté servers, the list of available remote applications in the Microsoft Remote Desktop window may be empty.

No Network Connection

If the Microsoft Remote Desktop application is launched with no network connection, the Avionté remote applications won't be able to load. This results in an empty list.

1. Ensure that the network connection is active and VPN is connected.
   
   
2. Launch the Microsoft Remote Desktop application again according to the .rpd file.

Incorrect Username and Password

If the application doesn't recognize the username or password used, the Microsoft Remote Desktop application won't be able to connect to the Avionté servers. This results in an empty list.

This will also occur if your Avionté password has been changed.

1. Click Workspaces.

2. Verify that the username is correct.
   
   

3. Enter the current password in the Password field.
   
   
4. Click Continue.

Keep Microsoft Remote Desktop in the Dock

Keeping a frequently used application in the dock makes it faster and easier to launch.

1. While the Microsoft Remote Desktop application is open, right-click on the icon in the dock.

   
   
   

2. Mouse over Options.
   
   

3. Click Keep in Dock.
   
   

Connect to Core Application Via Third-Party RDP Client

Any RDP client that supports Microsoft RDP Protocol version 7.0 can be used to connect to the Core Application. The process of configuring other RDP clients will be similar to those described above for the Microsoft client above.

The table below lists the common information needed to configure an RDP client. In all cases, “companycode” should be replaced with your Company Code.

Type	Info
Host address	prod-cl-sh.aviontego.com
Gateway address	companycode-gw.aviontego.com
Username	Avionté username
Password	Avionté password

Connect to a Parallel Environment

The method for connecting to a parallel environment is identical to those outlined above. However, each method requires the substitution of a parallel environment URL.

The table below lists each parallel environment and the URL that should be used to connect to it.

Parallel Environment URLs

Environment Name	URL
Aero Platform	https://companycode-preprod.avionte.com
Core Application	https://companycode-preprod.aviontego.com
Core Application RDC Computer Name	https://companycode-preprod.sh.aviontego.com
Core Application RDC Server Name	https://companycode-preprod.gw.aviontego.com

3rd party link Disclaimer: These links are being provided as a convenience and for informational purposes only; they do not constitute an endorsement or an approval by [The author] of any of the products, services or opinions of the corporation or organization or individual. [The author] bears no responsibility for the accuracy, legality or content of the external site or for that of subsequent links. Contact the external site for answers to questions regarding its content.