Installing a Gatway on MacOS

The Cimar Gateway for Mac is currently in Alpha stage and may incur issues. It also does not currently facilitate all the features of the Windows version, however, it will be sufficient for most use cases.

Installing a the MacOS gateway is very similar to the Windows installation however, it will require you to open the terminal application on your computer. It is only a few simple commands however, you can reach out to Cimar support for help if required. 

Instructions

1. Download installer file
   1. Through UI
      1. Go to Administration → Gateways → Download Gateway Software
      2. Select “Download for Mac”
   2. Through URL
      1. Go to: https://cloud.cimar.co.uk/download/AmbraWatchdog.dmg
      2. If on our Access stack go to: https://access.cimar.co.uk/download/AmbraWatchdog.dmg
2. Run the AmbraWatchdog.dmg file download
3. Drag the “Cimar Gateway” application to your “Applications” folder
4. Go to your “Applications” folder and search for the Cimar Gateway application
5. Remove the space in the application name by renaming the file
6. Run the application
7. A popup will ask you if you are sure you want to open the app, click “Open”
   1. If “Open” isn’t available, you may need to approve the application through your “Security & Privacy” settings. See here for more.
8. Click “Create Gateway” - This will automatically open up your browser
9. Sign in with your Cimar credentials
10. Select the Gateway Owner
    1. This will be the namespace/worklist that the gateway ties too. I.e studies be default will be harvested into this workflow
11. Give the gateway a logical name
    1. We suggest appending the host machine's IP address for easier account administration
    2. For example: Zac’s Hospital (10.15.120.2)
12. Set the type to: “Gateway”
13. Provide the contact information for the gateway
    1. These details will not be used for marketing purposes. We recommend providing the best support details should access to the gateway be required
14. Click save
15. Copy the provided serial number into the respective field in the Create Cimar Gateway application
16. Click “Validate and Save”
17. Click “OK” on the next popup
18. Enter your system's password
19. Wait about two minutes for the system to install the Gateway as a service on your computer
20. You will know the gateway is working when you see it pinging the Cloud in the Gateway list

Troubleshooting

• I waited two minutes but i’m not seeing the gateway pinging in the Cloud
  • In your terminal enter the following (you will need to enter your system password):

    sudo ls /Library/LaunchDaemons | grep -i ambra
    		

  • In your terminal if the gateway installed correctly you should have two .plist files returned:
    • com.ambra.gateway.plist
    • com.ambra.watchdog.plist
  • If you only have com.ambra.watchdog.plist run the following commands:

    • sudo launchctl unload /Library/LaunchDaemons/com.ambra.watchdog.plist
      			

    • sudo launchctl load /Library/LaunchDaemons/com.ambra.watchdog.plist
      			

  • Wait again for a couple of minutes to see if com.ambra.gateway.plist appears.
  • If com.ambra.gateway.plist still does not appear trying restarting the entire installation process

Checking the logs

View Recent Logs

1. Open a terminal
2. Run the following command:

   tail -f /var/log/ambra/gateway/log.log
   	

View All Logs

1. Open a terminal
2. Run the following command:

   open /var/log/ambra/gateway/
   	

3. The log files beginning with log.xxx is where logs regarding network communication and interaction with the Cloud is located. It is the log file you will require in 99% of cases.
4. A new log file is created for every day and is labelled accordingly
5. The file log.log is the log file for today

How to Uninstall Gateway

1. Open a terminal
2. Enter the following command:

   sudo /opt/ambra/GatewayUninstall.sh && sudo rm -f /opt/ambra/node.json