Changing the IP of Porta On Prem

After the initial set up of Porta VM and Porta On Prem, you may eventually want, or need, to make changes to your network, or otherwise change the static IP address of Porta VM.

This guide will walk you through the steps needed to ensure your VM and its applications are accessible at a new IP address.

Tip

During this process, you will be prompted for thesudo password; this is the Porta VM password provided to you.

Warning

If these commands are run using an SSH connection (a Windows Powershell or Terminal) to access the VM, your connection will be disrupted while the script is running and the setup will fail.

1. Disable the current static IP

1. Ensure your Porta VM is already running.

2. Using the native VirtualBox terminal window of the running virtual machine, log in to the VM:

   • Type the username portavm and hit Enter,
   • Type the password provided to you and hit Enter again to log in.
3. Run the following command to disable the current static IP address and enter thesudo password when prompted:

   sudo ./scripts/disable_static_ip.sh

4. Restart the VM with the command sudo reboot and wait for it to display the log in screen once more.

2. Set up the new static IP

1. Log in to the native VM terminal again.
2. Follow the steps to set up a static IP address as outlined below:
   1. Ensure your Porta VM is already running.

   2. Using the native VirtualBox terminal window of the running virtual machine, log in to the VM:

      • Type the username portavm and hit Enter,
      • Type the password provided to you and hit Enter again to log in.
   3. Run the following command to begin setting up a static IP address and enter the enter the sudo password when prompted:

      sudo ./scripts/setup_static_ip.sh

   4. The script will perform a network scan to find available IP addresses on your network.

      Caution

      If the network scan fails to complete or doesn’t find any available IPs, you’ll be asked “Would you like to manually enter an IP address?”

      1. Type y and press Enter.
      2. Type a full, valid IP address (e.g., 192.168.1.100), and hit Enter.
         • If the IP appears to be in use, you’ll be asked to confirm by typing y and pressing Enter.
   5. Select an IP address for the virtual machine by typing the number corresponding to one of the listed available IPs and pressing Enter.
      • If you choose to enter a custom IP address:
      • Enter the full IP address (e.g., 192.168.1.100)
      • If the entered IP appears to be in use, you’ll be asked to confirm. If you are sure the IP is safe to use, type y and pressing Enter.

      Tip

      If you’re unsure of available IP addresses, contact your network administrator or IT specialist.

   6. Next, select the machine role (also known as its type) by entering the number corresponding to one of the following options and pressing Enter:
      1. main
      2. backup
      3. arbiter

      Note

      If you’re only using one machine for Porta, select 1 formain.

   7. The script will then proceed to configure the VM with the selected static IP address and machine role.
      • You will see a lot of output in the terminal, including password prompts, but you can ignore it.
   8. When IP configuration is complete, the script will print “Static IP setup completed successfully! VM is now accessible at IP:” and list the new static IP address.

3. Use Porta Manager to fix Porta’s IP

1. When static IP setup finishes, access and log in to the Porta Manager.
2. In the Porta Manager sidebar, navigate to the Porta Configuration Management section and click on the Machines menu item.
3. In the Machines table, locate the row for your Porta VM and click Edit on the right side of the row.
4. On the Edit Machine page, update the IP Address field to match the new static IP address you just set for the VM, then click Save Changes.
5. Return to the Porta Manager dashboard by clicking on the Dashboard menu item in the sidebar.
6. On the Porta Manager dashboard, use the Fix IP Settings button to fix Porta’s IP.
7. In the pop-up that appears, confirm that you want to update Porta’s IP address by clicking Confirm.
8. Wait for the process to complete. You will see a success message indicating that Porta’s IP address has been updated successfully when it has finished.
9. You should now be able to access and use Porta as usual.