From f3ca213c8745ab693331b380bd3360ef4e6fb664 Mon Sep 17 00:00:00 2001 From: Hooverdan96 Date: Tue, 22 Oct 2024 10:55:27 -0700 Subject: [PATCH 01/10] Initial draft for special installation scenarios --- installation/installer-howto.rst | 97 ++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/installation/installer-howto.rst b/installation/installer-howto.rst index 9e87815c..d57aa2c1 100644 --- a/installation/installer-howto.rst +++ b/installation/installer-howto.rst @@ -270,3 +270,100 @@ See our FAQ entry: :ref:`faq_rockstor4_repos` **NOTE: No Rockstor package update repository is configured until an Update Channel is selected.** + + +.. _special_install_scenarios: + +Special Installation Scenarios +------------------------------- +There a some specific installation use cases that have been reported over the +years, that are documented here: + +Assign static IP address after installation but before WebUI setup +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If during setup the network architecture requires a static IP address on the Rockstor appliance's +network interface :code:`Network Manager` can be used to force a static IP address on the network interface. + +Check Network connection using the command line: + +.. code-block:: console + + Rockstorsys:~$ nmcli connection show + NAME UUID TYPE DEVICE + enp0s3 aa44c29f-33e8-358f-879b-e0b8efae27f3 ethernet enp0s3 + +In order to make this a static connection, here is an example on how this can be set up using `nmcli`: + +.. code-block:: console + + nmcli connection modify 'enp0s3' \ + connection.autoconnect yes \ + ipv4.method manual \ + ipv4.address 192.168.22.199/24 \ + ipv4.gateway 192.168.22.1 \ + ipv4.dns 8.8.8.8, 8.8.4.4. + +Upon successful completion of the command the connection will receive a static IP address: + +* automatically (i.e. whenever the network management is started) +* static address with +* IP address of 192.168.1.199 and +* Gateway of 192.168.22.1 and +* DNS1 and DNS2 server 8.8.8.8 and 8.8.4.4 respectively. + +To move the connection back to to `dhcp` mode, the above settings need to be reverted: + +.. code-block:: console + + nmcli con mod "enp0s3" \ + ipv4.method "auto" + ipv4.addresses "" \ + ipv4.gateway "" \ + ipv4.dns "" + +For either of these changes to take effect run + +.. code-block:: console + + nmcli connection up "enp0s3" + +or reboot the system. + +.. note:: + The above is meant for setting up a specific connection **before** the installation/configuration is completed using Rockstor's WebUI. + Once the Rockstor installation is complete, a static IP can be assigned from the WebUI. Under most circumstances neither + should be necessary, as most routers today offer IP address reservation that will effectively result in a static IP address + assigned to the Rockstor appliance (which by default uses `dhcp` to automatically obtain an IP address from the gateway). + +Proxy for private network +^^^^^^^^^^^^^^^^^^^^^^^^^ + +In some network architectures, a proxy is required to be able to manage updates from external sources +like OpenSUSE upstream packages, or check for and update a new version of the Rockstor software. + +This `KB 7006845 `_ provides some insights into how +to set up a Proxy using the command line. + +VMWare guest tools installation +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +As VMWare is a commmon virtualization package that is used by the Rockstor (alongside with others VirtualBox, Proxmox, etc.), +there is a useful toolset available that helps with various aspects of the integration between the host and guest among other tools +(similar guest extensions exist under VirtualBox as well): **open-vm-tools** + +There is the option to build this package into the custom installer, so it becomes part of the initial installation routine. +When building a customer installer to include it, using the `Rockstor installer `_ +the package is already contained in the **rockstor.kiwi** file, albeit commented out. + +.. note:: + + This is intended for more advanced users that are comfortable creating their own installers with custom content. + +To install the package after Rockstor has already been installed on a VMWare Guest instance, go to the command line and run: + +.. code:: console + + zypper install open-vm-tools + +Subsequent updates to the package will be automatically considered during Rockstor's upstream package checks. From e6ae1246f157adc1635832d450eaf92a9c81b222 Mon Sep 17 00:00:00 2001 From: Hooverdan96 Date: Fri, 25 Oct 2024 10:50:31 -0700 Subject: [PATCH 02/10] break out special install scenarios - break out into separate document - updated toctree - reference to new document in installer-howto - updating formatting to honor start each new sentence in a new line. --- installation/install.rst | 1 + installation/installer-howto.rst | 147 ++++-------------- .../special-install-scenarios-howto.rst | 97 ++++++++++++ 3 files changed, 127 insertions(+), 118 deletions(-) create mode 100644 installation/special-install-scenarios-howto.rst diff --git a/installation/install.rst b/installation/install.rst index a6650bba..7ee3bb63 100644 --- a/installation/install.rst +++ b/installation/install.rst @@ -15,6 +15,7 @@ that we have a :ref:`pre_install`. quickstart pre-install-howto installer-howto + special-install-scenarios-howto .. _quickeval: diff --git a/installation/installer-howto.rst b/installation/installer-howto.rst index d57aa2c1..3906094f 100644 --- a/installation/installer-howto.rst +++ b/installation/installer-howto.rst @@ -9,12 +9,12 @@ Thanks ------ Rockstor’s developers would like to thank the entire OSS community for making -any of this possible. Specifically with our recent move / rebase on openSUSE -Leap, our thanks go to the openSUSE/SuSE organisations and the larger -community for the extreme generosity we all benefit from in a myriad of seen -and unseen ways. +any of this possible. +Specifically with our recent move / rebase on openSUSE Leap, our thanks go to +the openSUSE/SuSE organisations and the larger community for the extreme +generosity we all benefit from in a myriad of seen and unseen ways. -**Please note: Rockstor is in no way affiliated with openSUSE / SuSE and does +**Please note: Rockstor is in no way affiliated with openSUSE/SuSE and does not wish, under any circumstances, to misrepresent these organisations.** *Any errors you encounter are most likely our fault and we try, on a current volunteer basis, to support our users via our* @@ -23,13 +23,14 @@ volunteer basis, to support our users via our* It is hoped that Rockstor’s ongoing small contribution back to the larger community is of value, and if this is so for you please consider either subscribing to our Stable Channel updates or taking part in our developer -orientated Testing Channel. Details of these Rockstor package update services -are available in our subsection on :ref:`update_channels`. Rockstor’s ongoing -development is wholly dependent on community support via either of these -channels and by positively participating in our forum, linked above. It is -hoped that in time we can contribute back more significantly, and possibly -financially, as our own community and Stable Channel subscriptions grow. Also -note that irrespective of Rockstor update channel selection or otherwise, +orientated Testing Channel. +Details of these Rockstor package update services are available in our +subsection on :ref:`update_channels`. Rockstor’s ongoing development is wholly +dependent on community support via either of these channels and by positively +participating in our forum, linked above. +It is hoped that in time we can contribute back more significantly, and possibly +financially, as our own community and Stable Channel subscriptions grow. +Also note that irrespective of Rockstor update channel selection or otherwise, upstream updates are available by normal command line means and via our Web-UI. See :ref:`dash_and_updates` later in this guide for the details. @@ -39,13 +40,13 @@ Our "Built on openSUSE" Kiwi-ng created installer ------------------------------------------------- The existence of this installer, and those of many Linux distributions, is down -in a major part to the Kiwi installer creation tool. I would specifically like -to thank `Marcus Schafer `_ and David -`Cassany Viladomat `_ of openSUSE/SuSE for +in a major part to the Kiwi installer creation tool. +I would specifically like to thank `Marcus Schafer `_ +and David `Cassany Viladomat `_ of openSUSE/SuSE for their timely and rapid oem, partition, swap, and btrfs related fixes that were -required for our initial version of this installer. Please contribute to this -important multi-distribution upstream project if you have the means and/or -talent `KIWI - Next Generation `_. +required for our initial version of this installer. +Please contribute to this important multi-distribution upstream project if you have +the means and/or talent `KIWI - Next Generation `_. Initial Selection Screen ^^^^^^^^^^^^^^^^^^^^^^^^ @@ -74,14 +75,14 @@ If unsure do not proceed and select via Tab key and then Enter. :align: center Use cursor keys to highlight, then the "Enter" key to select. -Only devices less than 5000 GB (5 TB) are shown. Larger disks are assumed to be data -disks. +Only devices less than 5000 GB (5 TB) are shown. +Larger disks are assumed to be data disks. Destroying ALL data on ..., continue ? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Do not proceed if at all unsure. This will wipe the entire contents of the -indicated drive. +Do not proceed if at all unsure. +This will wipe the entire contents of the indicated drive. .. image:: /images/installation/installer-howto/destroy-all-data.png :width: 100% @@ -132,7 +133,8 @@ The included **rockstor** package is :ref:`rockstor_license` :align: center Use cursor keys or Page-up / Page-down (space bar) to view the entire -agreement. There are about 3 pages: Enter key to 'Exit' & 'Agree', or cursor +agreement. +There are about 3 pages: Enter key to 'Exit' & 'Agree', or cursor keys to select 'No' in pop up. Select Time Zone @@ -229,8 +231,8 @@ Welcome banner ^^^^^^^^^^^^^^ Directly after the initial Rockstor setup the following welcome banner -introduces the Rockstor package Update Channels. A link to our documentation -explaining these channels is included: +introduces the Rockstor package Update Channels. +A link to our documentation explaining these channels is included: .. image:: /images/installation/installer-howto/initial_welcome_banner.png :align: center @@ -272,98 +274,7 @@ See our FAQ entry: :ref:`faq_rockstor4_repos` Update Channel is selected.** -.. _special_install_scenarios: - -Special Installation Scenarios -------------------------------- -There a some specific installation use cases that have been reported over the -years, that are documented here: - -Assign static IP address after installation but before WebUI setup -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -If during setup the network architecture requires a static IP address on the Rockstor appliance's -network interface :code:`Network Manager` can be used to force a static IP address on the network interface. - -Check Network connection using the command line: - -.. code-block:: console - - Rockstorsys:~$ nmcli connection show - NAME UUID TYPE DEVICE - enp0s3 aa44c29f-33e8-358f-879b-e0b8efae27f3 ethernet enp0s3 - -In order to make this a static connection, here is an example on how this can be set up using `nmcli`: - -.. code-block:: console - - nmcli connection modify 'enp0s3' \ - connection.autoconnect yes \ - ipv4.method manual \ - ipv4.address 192.168.22.199/24 \ - ipv4.gateway 192.168.22.1 \ - ipv4.dns 8.8.8.8, 8.8.4.4. - -Upon successful completion of the command the connection will receive a static IP address: - -* automatically (i.e. whenever the network management is started) -* static address with -* IP address of 192.168.1.199 and -* Gateway of 192.168.22.1 and -* DNS1 and DNS2 server 8.8.8.8 and 8.8.4.4 respectively. - -To move the connection back to to `dhcp` mode, the above settings need to be reverted: - -.. code-block:: console - - nmcli con mod "enp0s3" \ - ipv4.method "auto" - ipv4.addresses "" \ - ipv4.gateway "" \ - ipv4.dns "" - -For either of these changes to take effect run - -.. code-block:: console - - nmcli connection up "enp0s3" - -or reboot the system. - .. note:: - The above is meant for setting up a specific connection **before** the installation/configuration is completed using Rockstor's WebUI. - Once the Rockstor installation is complete, a static IP can be assigned from the WebUI. Under most circumstances neither - should be necessary, as most routers today offer IP address reservation that will effectively result in a static IP address - assigned to the Rockstor appliance (which by default uses `dhcp` to automatically obtain an IP address from the gateway). - -Proxy for private network -^^^^^^^^^^^^^^^^^^^^^^^^^ - -In some network architectures, a proxy is required to be able to manage updates from external sources -like OpenSUSE upstream packages, or check for and update a new version of the Rockstor software. - -This `KB 7006845 `_ provides some insights into how -to set up a Proxy using the command line. - -VMWare guest tools installation -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -As VMWare is a commmon virtualization package that is used by the Rockstor (alongside with others VirtualBox, Proxmox, etc.), -there is a useful toolset available that helps with various aspects of the integration between the host and guest among other tools -(similar guest extensions exist under VirtualBox as well): **open-vm-tools** - -There is the option to build this package into the custom installer, so it becomes part of the initial installation routine. -When building a customer installer to include it, using the `Rockstor installer `_ -the package is already contained in the **rockstor.kiwi** file, albeit commented out. - -.. note:: - - This is intended for more advanced users that are comfortable creating their own installers with custom content. - -To install the package after Rockstor has already been installed on a VMWare Guest instance, go to the command line and run: - -.. code:: console - - zypper install open-vm-tools -Subsequent updates to the package will be automatically considered during Rockstor's upstream package checks. + There a some specific installation use cases that have been reported over the + years, that are documented in the :ref:`special_install_scenarios`. diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst new file mode 100644 index 00000000..2c2a3e7e --- /dev/null +++ b/installation/special-install-scenarios-howto.rst @@ -0,0 +1,97 @@ +.. _special_install_scenarios: + +Special Installation Scenarios +============================== + +Since Rockstor can accommodate a wide range of hardware configurations, as well +as virtual machine set ups, there have been instances reported over the years that +required some specific actions to enable setting up Rockstor on a new system. +While the friendly `Rockstor forum `_ contains many more +scenarios and resolutions that can be searched for, some recurring themes are +documented below: + +Assign static IP address after installation but before WebUI setup +------------------------------------------------------------------ + +If during setup the network architecture requires a static IP address on the Rockstor appliance's +network interface :code:`Network Manager` can be used to force a static IP address on the network interface. + +Check Network connection using the command line: + +.. code-block:: console + + Rockstorsys:~$ nmcli connection show + NAME UUID TYPE DEVICE + enp0s3 aa44c29f-33e8-358f-879b-e0b8efae27f3 ethernet enp0s3 + +In order to make this a static connection, here is an example on how this can be set up using `nmcli`: + +.. code-block:: console + + nmcli connection modify 'enp0s3' \ + connection.autoconnect yes \ + ipv4.method manual \ + ipv4.address 192.168.22.199/24 \ + ipv4.gateway 192.168.22.1 \ + ipv4.dns 8.8.8.8, 8.8.4.4. + +Upon successful completion of the command the connection will receive a static IP address: + +* automatically (i.e. whenever the network management is started) +* static address with +* IP address of 192.168.1.199 and +* Gateway of 192.168.22.1 and +* DNS1 and DNS2 server 8.8.8.8 and 8.8.4.4 respectively. + +To move the connection back to to `dhcp` mode, the above settings need to be reverted: + +.. code-block:: console + + nmcli con mod "enp0s3" \ + ipv4.method "auto" + ipv4.addresses "" \ + ipv4.gateway "" \ + ipv4.dns "" + +For either of these changes to take effect run + +.. code-block:: console + + nmcli connection up "enp0s3" + +or reboot the system. + +.. note:: + The above is meant for setting up a specific connection **before** the installation/configuration is completed using Rockstor's WebUI. + Once the Rockstor installation is complete, a static IP can be assigned from the WebUI. Under most circumstances neither should be necessary, as most routers today offer IP address reservation that will effectively result in a static IP address assigned to the Rockstor appliance (which by default uses `dhcp` to automatically obtain an IP address from the gateway). + +Proxy for private network +------------------------- + +In some network architectures, a proxy is required to be able to manage updates from external sources +like OpenSUSE upstream packages, or check for and update a new version of the Rockstor software. + +This `KB 7006845 `_ provides some insights into how +to set up a Proxy using the command line. + +VMWare guest tools installation +------------------------------- + +As VMWare is a commmon virtualization package that is used by the Rockstor (alongside with others VirtualBox, Proxmox, etc.), there is a useful toolset available that helps with various aspects of the integration between +the host and guest among other tools (similar guest extensions exist under VirtualBox as well): **open-vm-tools**. + +There is the option to build this package into the custom installer, so it becomes part of the initial installation routine. +When building a customer installer to include it, using the `Rockstor installer `_ +the package is already contained in the **rockstor.kiwi** file, albeit commented out. + +.. note:: + + This is intended for more advanced users that are comfortable creating their own installers with custom content. + +To install the package after Rockstor has already been installed on a VMWare Guest instance, go to the command line and run: + +.. code:: console + + zypper install open-vm-tools + +Subsequent updates to the package will be automatically considered during Rockstor's upstream package checks. From c34d74bd9d1cf72e6b00e536eaf10315ccc38561 Mon Sep 17 00:00:00 2001 From: Hooverdan96 Date: Fri, 25 Oct 2024 14:50:08 -0700 Subject: [PATCH 03/10] update TOC to include install how-tos into How-To Level --- howtos.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/howtos.rst b/howtos.rst index 7927db4f..ef8c6df6 100644 --- a/howtos.rst +++ b/howtos.rst @@ -13,6 +13,8 @@ How-tos & Guides howtos/15-3_to_15-4 howtos/15-4_to_15-5 howtos/15-5_to_15-6 + installation/installer-howto + installation/special-install-scenarios-howto howtos/rpm_install howtos/v3_to_v4 howtos/reinstall From 07106ae522918086a976348106eaeab4665a8576 Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:21:11 -0700 Subject: [PATCH 04/10] Update installation/installer-howto.rst Co-authored-by: Philip Guyton --- installation/installer-howto.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/installation/installer-howto.rst b/installation/installer-howto.rst index 3906094f..c2ed615c 100644 --- a/installation/installer-howto.rst +++ b/installation/installer-howto.rst @@ -276,5 +276,4 @@ Update Channel is selected.** .. note:: - There a some specific installation use cases that have been reported over the - years, that are documented in the :ref:`special_install_scenarios`. + For advanced installation scenarios see: :ref:`special_install_scenarios`. From 846ce0fb0d76c0ff7c0cbba7f2ef8db4f14c584f Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:21:28 -0700 Subject: [PATCH 05/10] Update installation/special-install-scenarios-howto.rst Co-authored-by: Philip Guyton --- installation/special-install-scenarios-howto.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 2c2a3e7e..758260c0 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -39,7 +39,7 @@ Upon successful completion of the command the connection will receive a static I * automatically (i.e. whenever the network management is started) * static address with -* IP address of 192.168.1.199 and +* IP address of 192.168.22.199 and * Gateway of 192.168.22.1 and * DNS1 and DNS2 server 8.8.8.8 and 8.8.4.4 respectively. From ef9f3c5a3953c9a4937ad6deaa983ab010e253ff Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:21:44 -0700 Subject: [PATCH 06/10] Update installation/special-install-scenarios-howto.rst Co-authored-by: Philip Guyton --- installation/special-install-scenarios-howto.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 758260c0..7c1e0a79 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -43,7 +43,7 @@ Upon successful completion of the command the connection will receive a static I * Gateway of 192.168.22.1 and * DNS1 and DNS2 server 8.8.8.8 and 8.8.4.4 respectively. -To move the connection back to to `dhcp` mode, the above settings need to be reverted: +To move the connection back to `DHCP` mode, the above settings need to be reverted: .. code-block:: console From 2517bb94ad9701cc8a06ba57408c7e1a494b5dc6 Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:22:32 -0700 Subject: [PATCH 07/10] Update installation/special-install-scenarios-howto.rst Co-authored-by: Philip Guyton --- installation/special-install-scenarios-howto.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 7c1e0a79..2b7aab30 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -69,7 +69,7 @@ Proxy for private network ------------------------- In some network architectures, a proxy is required to be able to manage updates from external sources -like OpenSUSE upstream packages, or check for and update a new version of the Rockstor software. +like OpenSUSE upstream packages, or to check for and update to a new version of the `rockstor` package. This `KB 7006845 `_ provides some insights into how to set up a Proxy using the command line. From 167f67acade549ee3c16847595a81b9551f563e9 Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:22:52 -0700 Subject: [PATCH 08/10] Update installation/special-install-scenarios-howto.rst Co-authored-by: Philip Guyton --- installation/special-install-scenarios-howto.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 2b7aab30..7e2cbec7 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -77,8 +77,9 @@ to set up a Proxy using the command line. VMWare guest tools installation ------------------------------- -As VMWare is a commmon virtualization package that is used by the Rockstor (alongside with others VirtualBox, Proxmox, etc.), there is a useful toolset available that helps with various aspects of the integration between -the host and guest among other tools (similar guest extensions exist under VirtualBox as well): **open-vm-tools**. +When running Rockstor as a VMWare guest (unsupported), +consider using **open-vm-tools** to help with various aspects of the host/guest integration. +Similar guest extensions exist for VirtualBox. There is the option to build this package into the custom installer, so it becomes part of the initial installation routine. When building a customer installer to include it, using the `Rockstor installer `_ From 33bc6ba36471f72eefd13d6151e51afe35b348ff Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:23:25 -0700 Subject: [PATCH 09/10] Update installation/special-install-scenarios-howto.rst Co-authored-by: Philip Guyton --- installation/special-install-scenarios-howto.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 7e2cbec7..62d230f3 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -81,9 +81,9 @@ When running Rockstor as a VMWare guest (unsupported), consider using **open-vm-tools** to help with various aspects of the host/guest integration. Similar guest extensions exist for VirtualBox. -There is the option to build this package into the custom installer, so it becomes part of the initial installation routine. -When building a customer installer to include it, using the `Rockstor installer `_ -the package is already contained in the **rockstor.kiwi** file, albeit commented out. +This or any package can be included into a custom installer, making them available during the initial installation. +For building a custom installer see our `rockstor-installer `_ repo. +The `open-vm-tools` package is already contained in the **rockstor.kiwi** file, albeit commented out. .. note:: From c6a70ea83f62b051564d390ccbd2eb9b5c12fecf Mon Sep 17 00:00:00 2001 From: Hooverdan96 <35113775+Hooverdan96@users.noreply.github.com> Date: Sat, 26 Oct 2024 08:34:25 -0700 Subject: [PATCH 10/10] rearrange static IP during installation section --- installation/special-install-scenarios-howto.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/installation/special-install-scenarios-howto.rst b/installation/special-install-scenarios-howto.rst index 62d230f3..1e8fa3c8 100644 --- a/installation/special-install-scenarios-howto.rst +++ b/installation/special-install-scenarios-howto.rst @@ -13,6 +13,13 @@ documented below: Assign static IP address after installation but before WebUI setup ------------------------------------------------------------------ +.. note:: + The below is meant for setting up a specific connection **before** the installation/configuration is + completed using Rockstor's WebUI. + Under most circumstances this should not be necessary, as most routers today offer IP address reservation + that will effectively result in a static IP address assigned to the Rockstor appliance + (which by default uses `DHCP` to automatically obtain an IP address from the gateway). + If during setup the network architecture requires a static IP address on the Rockstor appliance's network interface :code:`Network Manager` can be used to force a static IP address on the network interface. @@ -61,9 +68,6 @@ For either of these changes to take effect run or reboot the system. -.. note:: - The above is meant for setting up a specific connection **before** the installation/configuration is completed using Rockstor's WebUI. - Once the Rockstor installation is complete, a static IP can be assigned from the WebUI. Under most circumstances neither should be necessary, as most routers today offer IP address reservation that will effectively result in a static IP address assigned to the Rockstor appliance (which by default uses `dhcp` to automatically obtain an IP address from the gateway). Proxy for private network -------------------------