Skip to content

Network Overview and Configuration

We ship the OPXes & Octaves with an external router for network management (hereafter, the QM router). Using this router is optional. There are a few possible network configurations, and each modifies how we access the cluster. We list below four possible configurations and details on accessing the cluster. Please choose your relevant configuration by clicking on the tabs under the figure.

Networkconfig_options

Note

If you plan to connect the system to your local network, please check if it requires whitelisting the MAC address. Depending on the configuration below, you might need to whitelist the supplied router MAC address or the individual devices' MAC addresses. All QM devices have their MAC address printed on them. To find the QM router MAC address, follow the guide below or contact your QM representative.

In this scenario, both the QM router and the client PC are connected to the institute's network, with the QM router listed as a device on the network. All QM devices are in a local area network (LAN) behind the QM router.

Network Setup:

  1. If necessary, ensure the QM router is whitelisted with the institution's IT department.

  2. Connect the QM router to the network through port 1. By default, it will be assigned an IP through DHCP (Automatic). If a static IP is required, the IT department at the institution needs to provide it. More information on configuring the QM router can be found here.

Accessing the web admin and connecting to the cluster using Python can be done in the following way:

There is one web admin panel for all devices and clusters that is accessible by typing the IP address of the QM router in a web browser. If you are unsure what is the QM router's IP address is, see here. Moreover, all clusters behind the router must have the same version for the admin panel to control them.

To open a communication with the cluster in Python, use the following with the name of the cluster, as defined in the admin panel.

qmm = QuantumMachinesManager(host='QM_Router_IP', cluster_name='My_cluster_name')

There is one cluster per router, and the web admin panel is available by typing in the IP address of the QM router in a web browser. If you are unsure what is the QM router's IP address is, see here.

To open a communication with the cluster in Python, use the following:

qmm = QuantumMachinesManager(host='QM_Router_IP')

In this scenario the QM router and the client PC are connected to a local unmanaged switch. All QM devices are in a local area network (LAN) behind the QM router.

Network Setup:

  1. Connect the QM router to the switch through port one .

  2. Set the QM router's IP to a static one, as required by the switch's LAN. Instructions can be found here.

Accessing the web admin and connecting to the cluster using Python can be done in the following way:

There is one web admin panel for all devices and clusters that is accessible by typing the IP address of the QM router in a web browser. If you are unsure what is the QM router's IP address is, see here. Moreover, all clusters behind the router must have the same version for the admin panel to control them.

To open a communication with the cluster in Python, use the following with the name of the cluster, as defined in the admin panel.

qmm = QuantumMachinesManager(host='QM_Router_IP', cluster_name='My_cluster_name')

There is one cluster per router, and the web admin panel is available by typing in the IP address of the QM router in a web browser. If you are unsure what is the QM router's IP address is, see here.

To open a communication with the cluster in Python, use the following:

qmm = QuantumMachinesManager(host='QM_Router_IP')

In this scenario, the client PC is directly connected to the QM router.
The QM devices and the PC are in a local area network (LAN) behind the QM router.

Network Setup:

  1. Ensure that port 1 is unused on the QM router.

  2. Connect the other ports to the PC and QM devices.

Note

If your PC is connected to another network (e.g., for internet) with a proxy server, this may result in conflicts and may require excluding the QM router network (192.168.88.xxx) from the proxy. To accomplish this, we suggest asking for assistance from the institution's IT personnel or contacting us. It is recommended to set all QM devices (e.g., OPXes and Octaves) to static IP addresses.

Accessing the web admin and connecting to the cluster using Python can be done in the following way:

To access the web admin panel, type any device's IP in a web browser to access all clusters using the same QOP version. To find the IP of the devices connected, follow the steps below

To open a communication with the cluster in Python, use the following:

qmm = QuantumMachinesManager(host='MAIN_QM_OPX_IP') # If you have multiple clusters in the network, use the main OPX of each cluster 
qmm = QuantumMachinesManager(host='ANY_QM_OPX_IP', cluster_name='My_cluster_name')

To access the web admin panel, type the IP of the main OPX of the cluster in a web browser.

To open a communication with the cluster in Python, use the following:

qmm = QuantumMachinesManager(host='Main_OPX_IP')

Warning

This option is only officially supported from QOP

In this scenario, the QM router is unused, and all QM devices will be directly connected to your own network (typically a router).

Note

All QM devices shipped after June 2023 are configured to DHCP. Devices shipped before were configured with a static IP - 192.168.88.XXX.

Network Setup:

  1. Determine the IP requirements of your network, and set the devices' IPs accordingly. Contact QM support for assistance with changing IP addresses. If a static IP is required, it must be provided by the institution's IT department. Note that this frequently requires whitelisting the MAC addresses of all QM devices in advance.

Accessing the web admin and connecting to the cluster using Python can be done in the following way:

To access the web admin panel, type any device's IP in a web browser to access all clusters using the same QOP version. To find the IP of the devices connected, follow the steps below

To open a communication with the cluster in Python, use the following:

qmm = QuantumMachinesManager(host='MAIN_QM_OPX_IP') # If you have multiple clusters in the network, use the main OPX of each cluster 
qmm = QuantumMachinesManager(host='ANY_QM_OPX_IP', cluster_name='My_cluster_name')

Configuring the QM router

Configuring the router to static IP

If static IP is needed for your system, follow these steps:

  1. Connect a computer to the router (to any port 2-10).
  2. Connect to the router web interface by typing in the browser http://192.168.88.1:81
  3. Click cancel in the change password dialog.
  4. Click "Quick Set" at the top banner.
  5. Set up the Static IP:

staticIP

  1. Click "apply configuration" to save changes.
  2. Disconnect the computer from the router.

Note

The router's IP and MAC addresses can also be seen on this page.

  1. Connect a computer to the router (to any port 2-10).
  2. Connect to the router web interface by typing in the browser http://192.168.88.1
  3. Click cancel in the change password dialog.
  4. Click "Quick Set" at the top banner.
  5. Set up the Static IP:

staticIP

  1. Click "apply configuration" to save changes.
  2. Disconnect the computer from the router.

Note

The router's IP and MAC addresses can also be seen on this page.

View the router's IP and MAC addresses

Use the touch screen on the router's front panel to view information and optional configuration. At any stage you can click back and return to the previous screen.

  1. Click on "Interfaces" once

  2. Click on "ether1"

  3. To view the IP address press "Addresses" and to view the MAC address press "Info"

Check Devices IP
  1. Connect the devices and a computer to the local network of the QM router (ports 2-10)
  2. In CMD run: 
    ssh -o "UserKnownHostsFile=/dev/null" -o "StrictHostKeyChecking=no" admin@192.168.88.1 ip arp print
  3. Identify the IP of the device using its MAC addresses. The MAC address is printed on a sticker on the device.