mirror of
https://github.com/outbackdingo/sysadm.git
synced 2026-01-27 02:20:17 +00:00
Merge branch 'master' of github.com:trueos/sysadm
This commit is contained in:
@@ -21,15 +21,14 @@ Every dispatcher class request contains several parameters:
|
||||
| namespace | rpc | |
|
||||
| | | |
|
||||
+---------------+------------+--------------------------------------+
|
||||
| action | | Actions include "list" and "kill". |
|
||||
| | | |
|
||||
| action | | Actions include "list", "kill", and |
|
||||
| | | "run". |
|
||||
+---------------+------------+--------------------------------------+
|
||||
|
||||
The rest of this section provides examples of the available *actions*
|
||||
for each type of request, along with their responses.
|
||||
|
||||
.. index:: list, dispatcher
|
||||
|
||||
.. _List Processes:
|
||||
|
||||
List Processes
|
||||
@@ -131,4 +130,52 @@ running jobs within the dispatcher system.
|
||||
"id": "fooid",
|
||||
"name": "response",
|
||||
"namespace": "rpc"
|
||||
}
|
||||
}
|
||||
|
||||
.. index:: run, dispatcher
|
||||
.. _Run Processes:
|
||||
|
||||
Run Process(es)
|
||||
===============
|
||||
|
||||
The "run" action allows a user with full access to create new jobs
|
||||
within the dispatcher system.
|
||||
|
||||
**REST Request**
|
||||
|
||||
::
|
||||
|
||||
PUT /rpc/dispatcher
|
||||
{
|
||||
"action" : "run",
|
||||
"job_id" : "<some_command -with_flags>",
|
||||
"multi_job_id" : ["<command1>", "<command2>", "<command3>"]
|
||||
}
|
||||
|
||||
**WebSocket Request**
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"args" : {
|
||||
"action" : "run",
|
||||
"job_id" : "<some_command -with_flags>",
|
||||
"multi_job_id" : ["<command1>", "<command2>", "<command3>"]
|
||||
},
|
||||
"namespace" : "rpc",
|
||||
"name" : "dispatcher",
|
||||
"id" : "fooid"
|
||||
}
|
||||
|
||||
**Response**
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"args": {
|
||||
"started": ["job_id", "multi-job_id"]
|
||||
},
|
||||
"id": "fooid",
|
||||
"name": "response",
|
||||
"namespace": "rpc"
|
||||
}
|
||||
|
||||
@@ -14,6 +14,13 @@ JSON (JavaScript Object Notation) format. For detailed descriptions of
|
||||
these items, please refer to their respective websites at
|
||||
http://www.websocket.org and http://json.org/.
|
||||
|
||||
The |sysadm| API Reference Guide is freely available for sharing and
|
||||
redistribution under the terms of the
|
||||
`Creative Commons Attribution License <https://creativecommons.org/licenses/by/4.0/>`_.
|
||||
This means you have permission to copy, distribute, translate, and adapt
|
||||
the work as long as you attribute the |lumina| Project as the original
|
||||
source of the Handbook.
|
||||
|
||||
.. _Authentication:
|
||||
|
||||
Authentication
|
||||
|
||||
@@ -2185,20 +2185,20 @@ p {
|
||||
margin-bottom: 24px
|
||||
}
|
||||
h1 {
|
||||
font-size: 100%
|
||||
font-size: 2em
|
||||
}
|
||||
h2,
|
||||
.rst-content p.caption {
|
||||
font-size: 100%
|
||||
h2 {
|
||||
font-size: 1.75em
|
||||
}
|
||||
h3 {
|
||||
font-size: 100%
|
||||
font-size: 1.5em
|
||||
}
|
||||
h4 {
|
||||
font-size: 100%
|
||||
h4,
|
||||
.rst-content p.caption {
|
||||
font-size: 1.25em
|
||||
}
|
||||
h5 {
|
||||
font-size: 110%
|
||||
font-size: 1.1em
|
||||
}
|
||||
h6 {
|
||||
font-size: 100%
|
||||
@@ -2890,6 +2890,25 @@ filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#730000', end
|
||||
padding: 4px 6px;
|
||||
margin-bottom: 0.809em
|
||||
}
|
||||
#wy-menu\ rst-imagebox2 {
|
||||
margin-top: 15px;
|
||||
margin-left: 20px;
|
||||
margin-right: 20px;
|
||||
border: 3px solid gray;
|
||||
border-radius: 8px;
|
||||
background: gray;
|
||||
font-size: 75%;
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
}
|
||||
|
||||
|
||||
#wy-menu\ rst-imagebox2 > a:nth-child(4) > img:nth-child(1) {
|
||||
width: 75%;
|
||||
margin: 0 auto;
|
||||
display: block;
|
||||
}
|
||||
|
||||
.wy-side-nav-search>a:hover,
|
||||
.wy-side-nav-search .wy-dropdown>a:hover {
|
||||
background: rgba(255,255,255,0.1) none repeat scroll 0 0;
|
||||
@@ -3682,10 +3701,9 @@ span[id*='MathJax-Span'] {
|
||||
.wy-nav-side,
|
||||
div.related {
|
||||
background: #28343b;
|
||||
background: -moz-linear-gradient(top, #28343b 0%, #28343b 100%);
|
||||
background: -webkit-linear-gradient(top, #28343b 0%,#28343b 100%);
|
||||
background: linear-gradient(to bottom, #28343b 0%,#28343b 100%);
|
||||
filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#28343b', endColorstr='#28343b',GradientType=0 );
|
||||
/*background-image:url("../transparentfireball.png");
|
||||
background-position: center center;
|
||||
background-repeat: no-repeat;*/
|
||||
}
|
||||
code.kbd,
|
||||
code.file,
|
||||
|
||||
@@ -2185,20 +2185,20 @@ p {
|
||||
margin-bottom: 24px
|
||||
}
|
||||
h1 {
|
||||
font-size: 100%
|
||||
font-size: 2em
|
||||
}
|
||||
h2,
|
||||
.rst-content p.caption {
|
||||
font-size: 100%
|
||||
h2 {
|
||||
font-size: 1.75em
|
||||
}
|
||||
h3 {
|
||||
font-size: 100%
|
||||
font-size: 1.5em
|
||||
}
|
||||
h4 {
|
||||
font-size: 100%
|
||||
h4,
|
||||
.rst-content p.caption {
|
||||
font-size: 1.25em
|
||||
}
|
||||
h5 {
|
||||
font-size: 110%
|
||||
font-size: 1.1em
|
||||
}
|
||||
h6 {
|
||||
font-size: 100%
|
||||
@@ -2890,6 +2890,25 @@ filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#730000', end
|
||||
padding: 4px 6px;
|
||||
margin-bottom: 0.809em
|
||||
}
|
||||
#wy-menu\ rst-imagebox2 {
|
||||
margin-top: 15px;
|
||||
margin-left: 20px;
|
||||
margin-right: 20px;
|
||||
border: 3px solid gray;
|
||||
border-radius: 8px;
|
||||
background: gray;
|
||||
font-size: 75%;
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
}
|
||||
|
||||
|
||||
#wy-menu\ rst-imagebox2 > a:nth-child(4) > img:nth-child(1) {
|
||||
width: 75%;
|
||||
margin: 0 auto;
|
||||
display: block;
|
||||
}
|
||||
|
||||
.wy-side-nav-search>a:hover,
|
||||
.wy-side-nav-search .wy-dropdown>a:hover {
|
||||
background: rgba(255,255,255,0.1) none repeat scroll 0 0;
|
||||
@@ -3682,10 +3701,9 @@ span[id*='MathJax-Span'] {
|
||||
.wy-nav-side,
|
||||
div.related {
|
||||
background: #28343b;
|
||||
background: -moz-linear-gradient(top, #28343b 0%, #28343b 100%);
|
||||
background: -webkit-linear-gradient(top, #28343b 0%,#28343b 100%);
|
||||
background: linear-gradient(to bottom, #28343b 0%,#28343b 100%);
|
||||
filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#28343b', endColorstr='#28343b',GradientType=0 );
|
||||
/*background-image:url("../transparentfireball.png");
|
||||
background-position: center center;
|
||||
background-repeat: no-repeat;*/
|
||||
}
|
||||
code.kbd,
|
||||
code.file,
|
||||
|
||||
BIN
docs/client_handbook/images/update4a.png
Normal file
BIN
docs/client_handbook/images/update4a.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 29 KiB |
BIN
docs/client_handbook/images/upgrade1b.png
Normal file
BIN
docs/client_handbook/images/upgrade1b.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 84 KiB |
@@ -15,3 +15,9 @@ Indices and tables
|
||||
* :ref:`modindex`
|
||||
* :ref:`search`
|
||||
|
||||
The |sysadm| Client Handbook is freely available for sharing and
|
||||
redistribution under the terms of the
|
||||
`Creative Commons Attribution License <https://creativecommons.org/licenses/by/4.0/>`_.
|
||||
This means you have permission to copy, distribute, translate, and adapt
|
||||
the work as long as you attribute the |lumina| Project as the original
|
||||
source of the Handbook.
|
||||
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -34,3 +34,12 @@ msgstr ""
|
||||
#: ../../index.rst:25
|
||||
msgid ":ref:`search`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../index.rst:27
|
||||
msgid ""
|
||||
"The |sysadm| Client Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -381,37 +381,54 @@ The :guilabel:`Settings` tab is shown in
|
||||
|
||||
.. _update4:
|
||||
|
||||
.. figure:: images/update4.png
|
||||
.. figure:: images/update4a.png
|
||||
|
||||
: Settings Tab
|
||||
: Update Manager Settings Tab
|
||||
|
||||
This tab contains several configurable options:
|
||||
|
||||
* **Max Boot Environments:** |trueos| automatically creates a boot
|
||||
environment before updating any software, the operating system, or
|
||||
applying a system update. Once the configured maximum number of boot
|
||||
environments is reached, |trueos| will automatically prune (delete)
|
||||
the oldest automatically created boot environment. However, it will
|
||||
not delete any boot environments created manually using
|
||||
environments is reached, |trueos| will automatically delete the oldest
|
||||
automatically created boot environment. However, it will not delete
|
||||
any boot environments created manually using the
|
||||
:ref:`Boot Environment Manager`. The default number of boot
|
||||
environments is *5*, with an allowable range from *1* to *10*.
|
||||
|
||||
* **Automatically perform updates:** When checked, the automatic
|
||||
updater automatically keeps your system and packages up-to-date.
|
||||
An update has completed when the pop-up menu indicates a reboot is
|
||||
needed to complete the update process. If
|
||||
updater keeps the system and packages up-to-date. An update has
|
||||
completed when the pop-up menu indicates a reboot is needed to
|
||||
complete the update process. If
|
||||
:guilabel:`Automatically perform updates` is unchecked, an update will
|
||||
only occur at the user's discretion. Updates are not required to be
|
||||
initiated manually. |trueos| uses an automated updater which
|
||||
automatically checks for updates, no more than once per day, 20
|
||||
minutes after a reboot and then every 24 hours.
|
||||
only occur at the user's discretion. By default, updates will **not**
|
||||
be automatic. |trueos| uses an automated updater which checks for
|
||||
updates no more than once per day, 20 minutes after a reboot and then
|
||||
every 24 hours.
|
||||
|
||||
* **Custom Package Repository:** To use a custom package repository for
|
||||
updates, check this box. This will activate the :guilabel:`URL`
|
||||
field so the user can input the URL to the custom repository.
|
||||
* **Automatically reboot to finish updates:** This selection initiates
|
||||
a system reboot at a designated time in order to finish the update
|
||||
process. By default, this selection is **unchecked**. Once checked,
|
||||
the reboot time can be configured to a specific hour of the day.
|
||||
Highlight the hour number and either type a new hour, or use the
|
||||
:guilabel:`arrows` to increase or decrease the hour. Highlight
|
||||
:guilabel:`AM/PM` to adjust this value.
|
||||
|
||||
* **Repositories:** |trueos| uses two repositories for updates,
|
||||
:guilabel:`STABLE` and :guilabel:`UNSTABLE`. :guilabel:`STABLE` will
|
||||
only update to formally released updates. :guilabel:`UNSTABLE` is the
|
||||
testing location for upcoming updates. It is recommended only for
|
||||
advanced users or those who wish to help test |trueos| and |lumina|.
|
||||
|
||||
To use a custom package repository for updates, check
|
||||
:guilabel:`CUSTOM`. This will activate the :guilabel:`URL` field so
|
||||
the user can input the URL to the custom repository.
|
||||
|
||||
Once all options are configured to their desired settings, click
|
||||
:guilabel:`Save Settings`.
|
||||
|
||||
.. index:: updates
|
||||
.. _Upgrading from PC-BSD® 10.x to TrueOS®:
|
||||
.. _Upgrading from PCBSD 10.x to TrueOS:
|
||||
|
||||
Upgrading from |pcbsd| 10.x to |trueos|
|
||||
---------------------------------------
|
||||
@@ -435,7 +452,7 @@ previous |pcbsd| installation will remain.
|
||||
|
||||
.. note:: This option overwrites the contents of :file:`/etc`. If any
|
||||
custom configurations exist, save them to a backup or the home
|
||||
directory first. Alternately, use :ref:`Boot Environment Manager`
|
||||
directory first. Alternately, use the :ref:`Boot Environment Manager`
|
||||
post-installation to mount the previous |pcbsd| boot environment to
|
||||
copy over any configuration files which may not have been backed up.
|
||||
|
||||
@@ -444,46 +461,42 @@ To perform the installation to a new boot environment, start the
|
||||
`TrueOS® Handbook <https://www.trueos.org/handbook/trueos.html>`_. In
|
||||
the `System Selection Screen <https://www.trueos.org/handbook/install.html#system-selection-screen>`_,
|
||||
choose to install either a desktop or a server. Press :guilabel:`Next`
|
||||
to view the pop-up screen shown in :numref:`Figure %s <upgrade1a>`.
|
||||
to view the :guilabel:`Disk Selection` screen, shown in
|
||||
:numref:`Figure %s <upgrade1>`.
|
||||
|
||||
.. _upgrade1a:
|
||||
.. _upgrade1:
|
||||
|
||||
.. figure:: images/upgrade1a.png
|
||||
.. figure:: images/upgrade1b.png
|
||||
|
||||
: Install to Boot Environment
|
||||
: Disk Selection
|
||||
|
||||
To upgrade, select the existing pool to install into and press
|
||||
:guilabel:`OK`.
|
||||
|trueos| automatically detects if the drive has an existing boot
|
||||
environment, filling in the data as necessary. If no boot environments
|
||||
are detected, :guilabel:`Install into Boot Environment` will be greyed
|
||||
out. To upgrade, select :guilabel:`Install into Boot Environment` and
|
||||
choose which existing pool to install into from the drop-down menu. In
|
||||
the :ref:`Disk Selection Screen <upgrade1>`, the user is installing into
|
||||
the existing **tank** pool. Press :guilabel:`Next` when ready.
|
||||
|
||||
.. warning:: If you instead press :guilabel:`Cancel`, the installation
|
||||
will continue as usual and reformat the disks, destroying any
|
||||
existing data.
|
||||
.. warning:: Be sure :guilabel:`Install into Boot Environment` is
|
||||
checked before proceeding, or data can be lost.
|
||||
|
||||
If you press :guilabel:`OK` to proceed with an installation into a new
|
||||
boot environment, the installer will skip the "Disk Selection" screen
|
||||
and instead show a summary, seen in
|
||||
:numref:`Figure %s <upgrade2>`.
|
||||
A pop-up will appear, asking to start the default Full-Disk
|
||||
installation. Click :guilabel:`Yes` to start the installation.
|
||||
|
||||
.. _upgrade2:
|
||||
|
||||
.. figure:: images/upgrade2.png
|
||||
|
||||
: Start the Install to Boot Environment
|
||||
|
||||
Press :guilabel:`Next` to start the installation. Once the installation
|
||||
is complete, reboot the system and remove the installation media. The
|
||||
post-installation screens will run as described in the
|
||||
Once the installation is complete, reboot the system and remove the
|
||||
installation media. The post-installation screens will run as described
|
||||
in the
|
||||
`Post Installation Configuration and Installation Troubleshooting <https://www.trueos.org/handbook/postinstall.html>`_
|
||||
section of the |trueos| Handbook so you can configure the new
|
||||
installation.
|
||||
section of the |trueos| Handbook to configure the new installation.
|
||||
|
||||
.. note:: During the
|
||||
`Create a User Screen <https://www.trueos.org/handbook/postinstall.html#create-a-user-screen>`_
|
||||
process, recreate the primary user account using the same name used
|
||||
on the previous |pcbsd| system so |trueos| can associate the
|
||||
existing home directory with that user. Once logged in, use
|
||||
:ref:`User Manager` to recreate any other user accounts or to
|
||||
reassociate any PersonaCrypt accounts.
|
||||
process, recreate the primary user account using the same name user
|
||||
name and user id (UID) from the previous |pcbsd| system. This allows
|
||||
|trueos| to associate the existing home directory with that user.
|
||||
Once logged in, use :ref:`User Manager` to recreate any other user
|
||||
accounts or to reassociate any PersonaCrypt accounts.
|
||||
|
||||
.. index:: sysadm, configuration
|
||||
.. _Manage SSL Keys:
|
||||
@@ -503,10 +516,10 @@ becomes a low-risk operation as the updates are applied to a different
|
||||
boot environment. If needed, there is an option to reboot into a backup
|
||||
boot environment. Other examples of using boot environments include:
|
||||
|
||||
* When making software changes, you can take a snapshot of that
|
||||
* When making software changes, it is possible to take a snapshot of the
|
||||
boot environment at any stage during the modifications.
|
||||
|
||||
* Save multiple boot environments on your system and perform various
|
||||
* Save multiple boot environments on the system and perform various
|
||||
updates on each of them as needed. Install, test, and update different
|
||||
software packages on each.
|
||||
|
||||
@@ -859,21 +872,22 @@ home directory, default shell, and primary group. System accounts
|
||||
usually have a shell of *nologin* for security reasons, indicating an
|
||||
attacker can not login to the system using that account name.
|
||||
|
||||
.. index:: users
|
||||
.. index:: users, personacrypt
|
||||
.. _PersonaCrypt:
|
||||
|
||||
PersonaCrypt
|
||||
------------
|
||||
|
||||
|trueos| provides support for a security feature known as PersonaCrypt.
|
||||
A PersonaCrypt device is a removable USB media, such as a USB stick,
|
||||
formatted with ZFS and encrypted with GELI. This device is used to hold
|
||||
a specific user's home directory, meaning they can securely transport
|
||||
and access their personal files on any |trueos| or |pcbsd| 10.1.2 or
|
||||
higher system. For example, this can be used to securely access one's
|
||||
home directory from a laptop, home computer, and work computer. The
|
||||
device is protected by an encryption key and a password which is, and
|
||||
should be, separate from the user's login password.
|
||||
A PersonaCrypt device is a removable USB media, such as a USB flash
|
||||
drive, formatted with ZFS and encrypted with either GELI or PEFS. This
|
||||
device is used to hold a specific user's home directory, meaning they
|
||||
can securely transport and access their personal files on any |trueos|
|
||||
or |pcbsd| 10.1.2 or higher system. For example, this can be used to
|
||||
securely access one's home directory from a laptop, home computer, and
|
||||
work computer. The device is protected by an encryption key and a
|
||||
different (recommended) password separate from the user's login
|
||||
password.
|
||||
|
||||
.. note:: When a user is configured to use a PersonaCrypt device, that
|
||||
user can not login using an unencrypted session on the same system.
|
||||
@@ -882,14 +896,21 @@ should be, separate from the user's login password.
|
||||
unencrypted sessions on the same system, create two different user
|
||||
accounts, one for each type of session.
|
||||
|
||||
.. index:: users, personacrypt, geli
|
||||
.. _GELI:
|
||||
|
||||
GELI
|
||||
^^^^
|
||||
|
||||
PersonaCrypt uses GELI's ability to split the key into two parts: one
|
||||
being your passphrase, and the other being a key stored on disk.
|
||||
Without both of these parts, the media cannot be decrypted. This means
|
||||
if somebody steals the key and manages to get your password, it is still
|
||||
worthless without the system it was paired with.
|
||||
worthless without the system it was paired with. GELI is used by default
|
||||
in |trueos| as it is more fully featured over PEFS.
|
||||
|
||||
.. warning:: USB devices do eventually fail. Always backup any important
|
||||
files stored on the PersonaCrypt device to another device or system.
|
||||
files stored on the PersonaCrypt device to another device or system.
|
||||
|
||||
The :guilabel:`PersonaCrypt` tab can be used to initialize a
|
||||
PersonaCrypt device for any login user, **except** for the currently
|
||||
@@ -904,11 +925,11 @@ created and the entry for the user has been clicked.
|
||||
: Initialize PersonaCrypt Device
|
||||
|
||||
Before a user is configured to use PersonaCrypt on a |trueos| system,
|
||||
two buttons are available in the "PersonaCrypt" section of "Advanced
|
||||
Mode". Note this section is hidden if the currently logged in user is
|
||||
selected. Also, if you have just created a user and do not see these
|
||||
options, click :guilabel:`Save` then re-highlight the user to display
|
||||
these options:
|
||||
two buttons are available in the :guilabel:`PersonaCrypt` tab of
|
||||
:guilabel:`Advanced Mode`. Note this section is hidden if the currently
|
||||
logged in user is selected. Also, if you have just created a user and do
|
||||
not see these options, click :guilabel:`Save`, then re-highlight the
|
||||
user to display these options:
|
||||
|
||||
* **Initialize Device:** Used to prepare the USB device which will be
|
||||
used as the user's home directory.
|
||||
@@ -933,31 +954,6 @@ initialize the device. The User Manager may take a moment to prepare the
|
||||
device. Once initialization is complete, the User Manager screen
|
||||
will change to allow removal of PersonaCrypt.
|
||||
|
||||
.. Leave this commented as the current development may use some of these
|
||||
options from the old personacrypt initializer.
|
||||
|
||||
display the device's key options, as seen in
|
||||
:numref:`Figure %s <user6>`.
|
||||
|
||||
.. _user6:
|
||||
|
||||
.. figure:: images/user6.png
|
||||
|
||||
PersonaCrypt Key Options
|
||||
|
||||
Several options are now available:
|
||||
|
||||
* **Export Key:** Used to create a copy of the encryption key so it can
|
||||
be imported for use on another |trueos| system.
|
||||
|
||||
* **Disable Key (No Data):** Used to uninitialize the PersonaCrypt
|
||||
device on this system. Note the device can still be used to login to
|
||||
other |trueos| systems.
|
||||
|
||||
* **Disable Key (Import Data):** In addition to uninitializing the
|
||||
PersonaCrypt device on this system, copy the contents of the user's
|
||||
home directory to this system.
|
||||
|
||||
Once a user has been initialized for PersonaCrypt on the system, their
|
||||
user account will no longer be displayed when logging in, **unless**
|
||||
their PersonaCrypt device is inserted. Once the USB device is inserted,
|
||||
@@ -983,6 +979,52 @@ password associated with the PersonaCrypt device.
|
||||
**DO NOT** remove the PersonaCrypt device while logged in! Always log
|
||||
out of your session before physically removing the device.
|
||||
|
||||
.. index:: users, personacrypt, pefs
|
||||
.. _PEFS Encryption:
|
||||
|
||||
PEFS
|
||||
^^^^
|
||||
|
||||
`PEFS <http://pefs.io/>`_ stands for Private Encrypted File System. It
|
||||
is open source software freely available under the BSD license, and is
|
||||
included in |trueos| by default. PEFS runs on top of any existing file
|
||||
system, providing an encryption layer independent of the underlying file
|
||||
system. PersonaCrypt can be configured to use PEFS in place of GELI,
|
||||
which eliminates the need for external media, as the encrypted PEFS
|
||||
database is stored on the local disk.
|
||||
|
||||
.. warning:: While PEFS does not use a USB drive, be sure to print or
|
||||
otherwise backup the PEFS generated key fragment stored on the disk.
|
||||
|
||||
**Initialize PEFS with the Command Line**
|
||||
|
||||
Because PEFS does not use a USB drive with its encryption, the user will
|
||||
need a password file (pfile) containing the desired password, **before**
|
||||
initializing PEFS for a user account. Once this pfile is created,
|
||||
enabling PEFS through PersonaCrypt is accomplished in a CLI with
|
||||
:command:`personacrypt init <username> <pfile> PEFS`.
|
||||
|
||||
For example, the user account **test** has a pfile named
|
||||
:file:`testpfile.txt`, which contains the single text string of **test's**
|
||||
chosen password. Next, the administrator adds PEFS encryption to the
|
||||
**test** acount by opening a CLI, logging in as root, and typing:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
# personacrypt init test testpfile.txt PEFS
|
||||
|
||||
PersonaCrypt will initialize the account **test** with PEFS, using the
|
||||
string in :file:`testpfile.txt` as the new password.
|
||||
|
||||
The |sysadm| User Manager can also initialize a user account with PEFS
|
||||
by choosing :guilabel:`on-disk encryption (PEFS)` in the
|
||||
:guilabel:`Device` drop down menu of the :guilabel:`PersonaCrypt` tab.
|
||||
|
||||
In addition to initializing an account with PEFS, PersonaCrypt also
|
||||
supports importing and exporting PEFS on-disk keyfiles with
|
||||
:command:`personacrypt export <username>` and
|
||||
:command:`personacrypt import <keyfile>`, respectively.
|
||||
|
||||
.. index:: users
|
||||
.. _Managing Groups:
|
||||
|
||||
|
||||
@@ -9,11 +9,11 @@ SysAdm™ files are currently available from the
|
||||
|
||||
.. _building:
|
||||
|
||||
Building SysAdm™
|
||||
----------------
|
||||
Building |sysadm|
|
||||
-----------------
|
||||
|
||||
Several Qt Modules are required before attempting to build
|
||||
SysAdm™:
|
||||
|sysadm|:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
@@ -21,7 +21,7 @@ SysAdm™:
|
||||
Qt5 Concurrent (# pkg install qt5-concurrent)
|
||||
Qt5 Websockets (# pkg install qt5-websockets)
|
||||
|
||||
Building the prototype version of SysAdm™ assumes you have access to
|
||||
Building the prototype version of |sysadm| assumes you have access to
|
||||
github.com.
|
||||
|
||||
.. code-block:: none
|
||||
@@ -33,10 +33,10 @@ github.com.
|
||||
|
||||
.. _starting:
|
||||
|
||||
Starting SysAdm™
|
||||
----------------
|
||||
Starting |sysadm|
|
||||
-----------------
|
||||
|
||||
SysAdm™ can be started one of two ways: the traditional rc(8)
|
||||
|sysadm| can be started one of two ways: the traditional rc(8)
|
||||
mechanism or using the new jobd(8) mechanism
|
||||
|
||||
To run under rc(8)
|
||||
@@ -62,13 +62,13 @@ To run under jobd(8)
|
||||
% sudo jobctl org.pcbsd.sysadm-rest enable
|
||||
|
||||
.. danger:: Several ports on the system firewall will need to be opened
|
||||
for SysAdm™ to have remote access functionality:
|
||||
for |sysadm| to have remote access functionality:
|
||||
|
||||
* Port 12149 for WebSocket interaction.
|
||||
* Port 12150 for the REST interface.
|
||||
* Port 12151 for the SysAdm™ bridge server.
|
||||
* Port 12151 for the |sysadm| bridge server.
|
||||
|
||||
The user can also designate their own ports for SysAdm™.
|
||||
The user can also designate their own ports for |sysadm|.
|
||||
|
||||
.. _bridge init:
|
||||
|
||||
@@ -77,7 +77,7 @@ Bridge Initialization
|
||||
|
||||
Configuring and connecting to a bridge can be a complicated process.
|
||||
Thankfully, there are several steps that are done the first time a
|
||||
server and bridge are configured with SysAdm™ but do not need to be
|
||||
server and bridge are configured with |sysadm| but do not need to be
|
||||
repeated later. Once these steps are complete, it becomes a much simpler
|
||||
process for a new user to configure their client to communicate with the
|
||||
now configured server and bridge.
|
||||
@@ -125,7 +125,7 @@ Adding a Client to the Server/Bridge Connection
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. danger:: If you have an old SSL bundle from a pre-alpha version of
|
||||
SysAdm™ created before June 2016, it will need to be removed prior to
|
||||
|sysadm| created before June 2016, it will need to be removed prior to
|
||||
proceeding with the client initialization process.
|
||||
|
||||
In the client UI, create or import an SSL key bundle as prompted by the
|
||||
|
||||
@@ -5,37 +5,44 @@ Introduction
|
||||
|
||||
**Preface**
|
||||
|
||||
Written by users of the SysAdm™ management utility.
|
||||
Written by users of the |sysadm| management utility.
|
||||
|
||||
Version |version|
|
||||
|
||||
Copyright © 2016 iXSystems®.
|
||||
|
||||
Welcome to SysAdm™! This documentation is intended to educate the user
|
||||
on initializing and configuring the SysAdm™ remote management options.
|
||||
The |sysadm| Server Handbook is freely available for sharing and
|
||||
redistribution under the terms of the
|
||||
`Creative Commons Attribution License <https://creativecommons.org/licenses/by/4.0/>`_.
|
||||
This means you have permission to copy, distribute, translate, and adapt
|
||||
the work as long as you attribute the |lumina| Project as the original
|
||||
source of the Handbook.
|
||||
|
||||
Welcome to |sysadm|! This documentation is intended to educate the user
|
||||
on initializing and configuring the |sysadm| remote management options.
|
||||
Initialization and management will be documented in two separate
|
||||
chapters, :ref:`gettingstarted`, and :ref:`management`.
|
||||
|
||||
.. warning:: SysAdm™ is still under heavy development, and all
|
||||
.. warning:: |sysadm| is still under heavy development, and all
|
||||
information contained in the documentation is subject to change.
|
||||
|
||||
**What is SysAdm™?**
|
||||
|
||||
SysAdm™ is a middleware utility designed to streamline system management
|
||||
|sysadm| is a middleware utility designed to streamline system management
|
||||
with options for both local and remote access.
|
||||
|
||||
.. note:: By default, SysAdm™ does **not** allow for remote access.
|
||||
.. note:: By default, |sysadm| does **not** allow for remote access.
|
||||
The user must configure the system to allow this feature.
|
||||
|
||||
One unique element to SysAdm™ is how the middleware is designed to
|
||||
modify the system directly. SysAdm™ has no middleware database, which
|
||||
means all changes made with SysAdm™ modify the system configuration
|
||||
One unique element to |sysadm| is how the middleware is designed to
|
||||
modify the system directly. |sysadm| has no middleware database, which
|
||||
means all changes made with |sysadm| modify the system configuration
|
||||
files directly, resulting in a system administrator no longer needing to
|
||||
log into a system via SSH or relearn system management. SysAdm™ "speaks"
|
||||
log into a system via SSH or relearn system management. |sysadm| "speaks"
|
||||
the same language, allowing for simple and effective system
|
||||
administration.
|
||||
|
||||
For remote access, SysAdm™ is being designed to route encrypted traffic
|
||||
For remote access, |sysadm| is being designed to route encrypted traffic
|
||||
through a "bridge", a static announcement server which facilitates
|
||||
communication between the user's controlling device and the remote
|
||||
access system.
|
||||
@@ -47,14 +54,14 @@ record or alter critical information flow.
|
||||
|
||||
**Would you like to know more?**
|
||||
|
||||
Documentation for the SysAdm™ project is split amongst three handbooks:
|
||||
Documentation for the |sysadm| project is split amongst three handbooks:
|
||||
|
||||
* **API Reference Guide**: A library of all API calls and WebSocket
|
||||
requests for SysAdm™. This reference is constantly updated as new API
|
||||
requests for |sysadm|. This reference is constantly updated as new API
|
||||
calls are written. It can be found at https://api.sysadm.us/.
|
||||
|
||||
* **Client Handbook**: A detailed guide to all client side functions
|
||||
of SysAdm™.
|
||||
of |sysadm|.
|
||||
|
||||
* **Server Handbook**: A basic guide to initializing SysAdm™ with
|
||||
* **Server Handbook**: A basic guide to initializing |sysadm| with
|
||||
a bridge and server connection.
|
||||
@@ -1,14 +1,14 @@
|
||||
.. _management:
|
||||
|
||||
Managing SysAdm™
|
||||
================
|
||||
Managing |sysadm|
|
||||
=================
|
||||
|
||||
SysAdm™ comes with a standard configuration file located in
|
||||
|sysadm| comes with a standard configuration file located in
|
||||
:file:`/usr/local/etc/sysadm.conf.dist`.
|
||||
|
||||
It is possible to edit this file for a custom configuration, but the
|
||||
result will need to be saved as :file:`sysadm.conf`. Here are the
|
||||
current default settings for SysAdm™:
|
||||
current default settings for |sysadm|:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
@@ -36,5 +36,5 @@ This default configuration also has blacklist options:
|
||||
counter)
|
||||
BLACKLIST_AUTH_FAIL_RESET_MINUTES=10
|
||||
|
||||
Please note these default options are subject to change as the SysAdm™
|
||||
Please note these default options are subject to change as the |sysadm|
|
||||
utility is developed.
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -22,30 +22,6 @@ msgid ""
|
||||
"<https://github.com/trueos/sysadm>`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of SysAdm™ assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting SysAdm™"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:51
|
||||
msgid "To run under rc(8)"
|
||||
msgstr ""
|
||||
@@ -54,12 +30,6 @@ msgstr ""
|
||||
msgid "To run under jobd(8)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:76
|
||||
msgid "Port 12149 for WebSocket interaction."
|
||||
msgstr ""
|
||||
@@ -68,28 +38,10 @@ msgstr ""
|
||||
msgid "Port 12150 for the REST interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for SysAdm™."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:85
|
||||
msgid "Bridge Initialization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
" Once these steps are complete, it becomes a much simpler process for a new "
|
||||
"user to configure their client to communicate with the now configured server"
|
||||
" and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:94
|
||||
msgid ""
|
||||
"A list of current commands is available by typing :command:`-h` after the "
|
||||
@@ -146,13 +98,6 @@ msgstr ""
|
||||
msgid "Adding a Client to the Server/Bridge Connection"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:140
|
||||
msgid ""
|
||||
"In the client UI, create or import an SSL key bundle as prompted by the UI. "
|
||||
@@ -190,3 +135,103 @@ msgid ""
|
||||
" within it. Click on the bridged system to will open the standard UI, but "
|
||||
"note the connection is still being relayed through the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:22
|
||||
msgid "Building |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:24
|
||||
msgid "Several Qt Modules are required before attempting to build |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:33
|
||||
msgid ""
|
||||
"Building the prototype version of |sysadm| assumes you have access to "
|
||||
"github.com."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:46
|
||||
msgid "Starting |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:48
|
||||
msgid ""
|
||||
"|sysadm| can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
"using the new jobd(8) mechanism"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:73
|
||||
msgid ""
|
||||
"Several ports on the system firewall will need to be opened for |sysadm| to "
|
||||
"have remote access functionality:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:78
|
||||
msgid "Port 12151 for the |sysadm| bridge server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:80
|
||||
msgid "The user can also designate their own ports for |sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:87
|
||||
msgid ""
|
||||
"Configuring and connecting to a bridge can be a complicated process. "
|
||||
"Thankfully, there are several steps that are done the first time a server "
|
||||
"and bridge are configured with |sysadm| but do not need to be repeated "
|
||||
"later. Once these steps are complete, it becomes a much simpler process for "
|
||||
"a new user to configure their client to communicate with the now configured "
|
||||
"server and bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../basics.rst:136
|
||||
msgid ""
|
||||
"If you have an old SSL bundle from a pre-alpha version of |sysadm| created "
|
||||
"before June 2016, it will need to be removed prior to proceeding with the "
|
||||
"client initialization process."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Building SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Several Qt Modules are required before attempting to build SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Building the prototype version of SysAdm™ assumes you have access to "
|
||||
#~ "github.com."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Starting SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ can be started one of two ways: the traditional rc(8) mechanism or "
|
||||
#~ "using the new jobd(8) mechanism"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Several ports on the system firewall will need to be opened for SysAdm™ to "
|
||||
#~ "have remote access functionality:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Port 12151 for the SysAdm™ bridge server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The user can also designate their own ports for SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Configuring and connecting to a bridge can be a complicated process. "
|
||||
#~ "Thankfully, there are several steps that are done the first time a server "
|
||||
#~ "and bridge are configured with SysAdm™ but do not need to be repeated later."
|
||||
#~ " Once these steps are complete, it becomes a much simpler process for a new "
|
||||
#~ "user to configure their client to communicate with the now configured server"
|
||||
#~ " and bridge."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If you have an old SSL bundle from a pre-alpha version of SysAdm™ created "
|
||||
#~ "before June 2016, it will need to be removed prior to proceeding with the "
|
||||
#~ "client initialization process."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -19,10 +19,6 @@ msgstr ""
|
||||
msgid "**Preface**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the SysAdm™ management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:19
|
||||
msgid "Version |version|"
|
||||
msgstr ""
|
||||
@@ -31,55 +27,11 @@ msgstr ""
|
||||
msgid "Copyright © 2016 iXSystems®."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the SysAdm™ remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:28
|
||||
msgid ""
|
||||
"SysAdm™ is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:31
|
||||
#: ../../introduction.rst:38
|
||||
msgid "**What is SysAdm™?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:33
|
||||
msgid ""
|
||||
"SysAdm™ is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:36
|
||||
msgid ""
|
||||
"By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:39
|
||||
msgid ""
|
||||
"One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
"the system directly. SysAdm™ has no middleware database, which means all "
|
||||
"changes made with SysAdm™ modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
"allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:47
|
||||
msgid ""
|
||||
"For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:52
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"In order to address security concerns, the bridge device is always "
|
||||
"considered \"untrusted\" and several layers of encryption are added to all "
|
||||
@@ -87,30 +39,148 @@ msgid ""
|
||||
" alter critical information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:57
|
||||
#: ../../introduction.rst:64
|
||||
msgid "**Would you like to know more?**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:59
|
||||
msgid ""
|
||||
"Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#: ../../introduction.rst:17
|
||||
msgid "Written by users of the |sysadm| management utility."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:61
|
||||
#: ../../introduction.rst:23
|
||||
msgid ""
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
"The |sysadm| Server Handbook is freely available for sharing and "
|
||||
"redistribution under the terms of the `Creative Commons Attribution License "
|
||||
"<https://creativecommons.org/licenses/by/4.0/>`_. This means you have "
|
||||
"permission to copy, distribute, translate, and adapt the work as long as you"
|
||||
" attribute the |lumina| Project as the original source of the Handbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:65
|
||||
#: ../../introduction.rst:30
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"SysAdm™."
|
||||
"Welcome to |sysadm|! This documentation is intended to educate the user on "
|
||||
"initializing and configuring the |sysadm| remote management options. "
|
||||
"Initialization and management will be documented in two separate chapters, "
|
||||
":ref:`gettingstarted`, and :ref:`management`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:35
|
||||
msgid ""
|
||||
"|sysadm| is still under heavy development, and all information contained in "
|
||||
"the documentation is subject to change."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:40
|
||||
msgid ""
|
||||
"|sysadm| is a middleware utility designed to streamline system management "
|
||||
"with options for both local and remote access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:43
|
||||
msgid ""
|
||||
"By default, |sysadm| does **not** allow for remote access. The user must "
|
||||
"configure the system to allow this feature."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:46
|
||||
msgid ""
|
||||
"One unique element to |sysadm| is how the middleware is designed to modify "
|
||||
"the system directly. |sysadm| has no middleware database, which means all "
|
||||
"changes made with |sysadm| modify the system configuration files directly, "
|
||||
"resulting in a system administrator no longer needing to log into a system "
|
||||
"via SSH or relearn system management. |sysadm| \"speaks\" the same language,"
|
||||
" allowing for simple and effective system administration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:54
|
||||
msgid ""
|
||||
"For remote access, |sysadm| is being designed to route encrypted traffic "
|
||||
"through a \"bridge\", a static announcement server which facilitates "
|
||||
"communication between the user's controlling device and the remote access "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:66
|
||||
msgid ""
|
||||
"Documentation for the |sysadm| project is split amongst three handbooks:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:68
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
" server connection."
|
||||
"**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
"for |sysadm|. This reference is constantly updated as new API calls are "
|
||||
"written. It can be found at https://api.sysadm.us/."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:72
|
||||
msgid ""
|
||||
"**Client Handbook**: A detailed guide to all client side functions of "
|
||||
"|sysadm|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../introduction.rst:75
|
||||
msgid ""
|
||||
"**Server Handbook**: A basic guide to initializing |sysadm| with a bridge "
|
||||
"and server connection."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Written by users of the SysAdm™ management utility."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Welcome to SysAdm™! This documentation is intended to educate the user on "
|
||||
#~ "initializing and configuring the SysAdm™ remote management options. "
|
||||
#~ "Initialization and management will be documented in two separate chapters, "
|
||||
#~ ":ref:`gettingstarted`, and :ref:`management`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is still under heavy development, and all information contained in "
|
||||
#~ "the documentation is subject to change."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ is a middleware utility designed to streamline system management "
|
||||
#~ "with options for both local and remote access."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "By default, SysAdm™ does **not** allow for remote access. The user must "
|
||||
#~ "configure the system to allow this feature."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "One unique element to SysAdm™ is how the middleware is designed to modify "
|
||||
#~ "the system directly. SysAdm™ has no middleware database, which means all "
|
||||
#~ "changes made with SysAdm™ modify the system configuration files directly, "
|
||||
#~ "resulting in a system administrator no longer needing to log into a system "
|
||||
#~ "via SSH or relearn system management. SysAdm™ \"speaks\" the same language, "
|
||||
#~ "allowing for simple and effective system administration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For remote access, SysAdm™ is being designed to route encrypted traffic "
|
||||
#~ "through a \"bridge\", a static announcement server which facilitates "
|
||||
#~ "communication between the user's controlling device and the remote access "
|
||||
#~ "system."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Documentation for the SysAdm™ project is split amongst three handbooks:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**API Reference Guide**: A library of all API calls and WebSocket requests "
|
||||
#~ "for SysAdm™. This reference is constantly updated as new API calls are "
|
||||
#~ "written. It can be found at https://api.sysadm.us/."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Client Handbook**: A detailed guide to all client side functions of "
|
||||
#~ "SysAdm™."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "**Server Handbook**: A basic guide to initializing SysAdm™ with a bridge and"
|
||||
#~ " server connection."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -11,13 +11,17 @@ msgstr ""
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:13
|
||||
msgid "Managing SysAdm™"
|
||||
msgid "Managing |sysadm|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:15
|
||||
msgid ""
|
||||
"SysAdm™ comes with a standard configuration file located in "
|
||||
"|sysadm| comes with a standard configuration file located in "
|
||||
":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
msgstr ""
|
||||
|
||||
@@ -25,15 +29,30 @@ msgstr ""
|
||||
msgid ""
|
||||
"It is possible to edit this file for a custom configuration, but the result "
|
||||
"will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
"settings for SysAdm™:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:32
|
||||
msgid "This default configuration also has blacklist options:"
|
||||
"settings for |sysadm|:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../manage.rst:48
|
||||
msgid ""
|
||||
"Please note these default options are subject to change as the SysAdm™ "
|
||||
"Please note these default options are subject to change as the |sysadm| "
|
||||
"utility is developed."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Managing SysAdm™"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "SysAdm™ comes with a standard configuration file located in "
|
||||
#~ ":file:`/usr/local/etc/sysadm.conf.dist`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "It is possible to edit this file for a custom configuration, but the result "
|
||||
#~ "will need to be saved as :file:`sysadm.conf`. Here are the current default "
|
||||
#~ "settings for SysAdm™:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Please note these default options are subject to change as the SysAdm™ "
|
||||
#~ "utility is developed."
|
||||
#~ msgstr ""
|
||||
|
||||
@@ -2185,20 +2185,20 @@ p {
|
||||
margin-bottom: 24px
|
||||
}
|
||||
h1 {
|
||||
font-size: 100%
|
||||
font-size: 2em
|
||||
}
|
||||
h2,
|
||||
.rst-content p.caption {
|
||||
font-size: 100%
|
||||
h2 {
|
||||
font-size: 1.75em
|
||||
}
|
||||
h3 {
|
||||
font-size: 100%
|
||||
font-size: 1.5em
|
||||
}
|
||||
h4 {
|
||||
font-size: 100%
|
||||
h4,
|
||||
.rst-content p.caption {
|
||||
font-size: 1.25em
|
||||
}
|
||||
h5 {
|
||||
font-size: 110%
|
||||
font-size: 1.1em
|
||||
}
|
||||
h6 {
|
||||
font-size: 100%
|
||||
@@ -2890,6 +2890,25 @@ filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#730000', end
|
||||
padding: 4px 6px;
|
||||
margin-bottom: 0.809em
|
||||
}
|
||||
#wy-menu\ rst-imagebox2 {
|
||||
margin-top: 15px;
|
||||
margin-left: 20px;
|
||||
margin-right: 20px;
|
||||
border: 3px solid gray;
|
||||
border-radius: 8px;
|
||||
background: gray;
|
||||
font-size: 75%;
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
}
|
||||
|
||||
|
||||
#wy-menu\ rst-imagebox2 > a:nth-child(4) > img:nth-child(1) {
|
||||
width: 75%;
|
||||
margin: 0 auto;
|
||||
display: block;
|
||||
}
|
||||
|
||||
.wy-side-nav-search>a:hover,
|
||||
.wy-side-nav-search .wy-dropdown>a:hover {
|
||||
background: rgba(255,255,255,0.1) none repeat scroll 0 0;
|
||||
@@ -3682,10 +3701,9 @@ span[id*='MathJax-Span'] {
|
||||
.wy-nav-side,
|
||||
div.related {
|
||||
background: #28343b;
|
||||
background: -moz-linear-gradient(top, #28343b 0%, #28343b 100%);
|
||||
background: -webkit-linear-gradient(top, #28343b 0%,#28343b 100%);
|
||||
background: linear-gradient(to bottom, #28343b 0%,#28343b 100%);
|
||||
filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#28343b', endColorstr='#28343b',GradientType=0 );
|
||||
/*background-image:url("../transparentfireball.png");
|
||||
background-position: center center;
|
||||
background-repeat: no-repeat;*/
|
||||
}
|
||||
code.kbd,
|
||||
code.file,
|
||||
|
||||
@@ -15,6 +15,8 @@ USE_QT5= concurrent core network buildtools qmake gui websockets
|
||||
USES= pkgconfig tar:xz qmake
|
||||
MAKE_ARGS= PREFIX=${STAGEDIR}${PREFIX}
|
||||
|
||||
USE_OPENRC_SUBR= sysadm sysadm-bridge sysadm-rest
|
||||
|
||||
USE_GITHUB= yes
|
||||
GH_ACCOUNT= pcbsd
|
||||
GH_PROJECT= sysadm
|
||||
|
||||
45
port-files/files/sysadm-bridge.in
Executable file
45
port-files/files/sysadm-bridge.in
Executable file
@@ -0,0 +1,45 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
name="SysAdm Server (Bridge)"
|
||||
|
||||
depend() {
|
||||
need net
|
||||
after bootmisc
|
||||
keyword -shutdown
|
||||
}
|
||||
|
||||
start()
|
||||
{
|
||||
ebegin "Starting $name"
|
||||
start-stop-daemon --start -m -b -p /var/run/sysadm-bridge.pid \
|
||||
%%PREFIX%%/bin/sysadm-bridge
|
||||
eend $?
|
||||
}
|
||||
|
||||
stop()
|
||||
{
|
||||
ebegin "Stopping $name"
|
||||
start-stop-daemon --stop --exec %%PREFIX%%/bin/sysadm-bridge \
|
||||
-p /var/run/sysadm-bridge.pid
|
||||
eend $?
|
||||
}
|
||||
|
||||
ssl_keygen()
|
||||
{
|
||||
if [ ! -d "%%PREFIX%%/etc/sysadm" ] ; then
|
||||
mkdir -p %%PREFIX%%/etc/sysadm
|
||||
fi
|
||||
if [ ! -e "%%PREFIX%%/etc/sysadm/ws_bridge.key" ] ; then
|
||||
openssl req -x509 -nodes -newkey rsa:2048 \
|
||||
-keyout %%PREFIX%%/etc/sysadm/ws_bridge.key \
|
||||
-out %%PREFIX%%/etc/sysadm/ws_bridge.crt -days 102400 \
|
||||
-subj "/C=US/ST=MY/L=NULL/O=SysAdm/OU=SysAdm/CN=SysAdm/emailAddress=none@example.org" 2>/dev/null
|
||||
fi
|
||||
}
|
||||
|
||||
start_pre()
|
||||
{
|
||||
ssl_keygen "$1"
|
||||
}
|
||||
43
port-files/files/sysadm-rest.in
Executable file
43
port-files/files/sysadm-rest.in
Executable file
@@ -0,0 +1,43 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
name="SysAdm Server (REST)"
|
||||
|
||||
depend() {
|
||||
need net
|
||||
after bootmisc
|
||||
keyword -shutdown
|
||||
}
|
||||
|
||||
start()
|
||||
{
|
||||
ebegin "Starting $name"
|
||||
start-stop-daemon --start -m -b -p /var/run/sysadm-rest.pid \
|
||||
%%PREFIX%%/bin/sysadm-binary -- -rest
|
||||
eend $?
|
||||
}
|
||||
|
||||
stop()
|
||||
{
|
||||
ebegin "Stopping $name"
|
||||
start-stop-daemon --stop --exec %%PREFIX%%/bin/sysadm-binary \
|
||||
-p /var/run/sysadm-rest.pid
|
||||
eend $?
|
||||
}
|
||||
|
||||
ssl_keygen()
|
||||
{
|
||||
if [ ! -d "%%PREFIX%%/etc/sysadm" ] ; then
|
||||
mkdir -p %%PREFIX%%/etc/sysadm
|
||||
fi
|
||||
openssl req -x509 -nodes -newkey rsa:2048 \
|
||||
-keyout %%PREFIX%%/etc/sysadm/restserver.key \
|
||||
-out %%PREFIX%%/etc/sysadm/restserver.crt -days 1024 \
|
||||
-subj "/C=US/ST=MY/L=NULL/O=SysAdm/OU=SysAdm/CN=SysAdm/emailAddress=none@example.org" 2>/dev/null
|
||||
}
|
||||
|
||||
start_pre()
|
||||
{
|
||||
ssl_keygen "$1"
|
||||
}
|
||||
43
port-files/files/sysadm.in
Executable file
43
port-files/files/sysadm.in
Executable file
@@ -0,0 +1,43 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
name="SysAdm Server (WebSocket)"
|
||||
|
||||
depend() {
|
||||
need net
|
||||
after bootmisc
|
||||
keyword -shutdown
|
||||
}
|
||||
|
||||
start()
|
||||
{
|
||||
ebegin "Starting $name"
|
||||
start-stop-daemon --start -m -b -p /var/run/sysadm.pid \
|
||||
%%PREFIX%%/bin/sysadm-binary
|
||||
eend $?
|
||||
}
|
||||
|
||||
stop()
|
||||
{
|
||||
ebegin "Stopping $name"
|
||||
start-stop-daemon --stop --exec %%PREFIX%%/bin/sysadm-binary \
|
||||
-p /var/run/sysadm.pid
|
||||
eend $?
|
||||
}
|
||||
|
||||
ssl_keygen()
|
||||
{
|
||||
if [ ! -d "%%PREFIX%%/etc/sysadm" ] ; then
|
||||
mkdir -p %%PREFIX%%/etc/sysadm
|
||||
fi
|
||||
openssl req -x509 -nodes -newkey rsa:2048 \
|
||||
-keyout %%PREFIX%%/etc/sysadm/wsserver.key \
|
||||
-out %%PREFIX%%/etc/sysadm/wsserver.crt -days 1024 \
|
||||
-subj "/C=US/ST=MY/L=NULL/O=SysAdm/OU=SysAdm/CN=SysAdm/emailAddress=none@example.org" 2>/dev/null
|
||||
}
|
||||
|
||||
start_pre()
|
||||
{
|
||||
ssl_keygen "$1"
|
||||
}
|
||||
@@ -3,9 +3,6 @@ bin/sysadm-server
|
||||
bin/sysadm-bridge
|
||||
bin/sysadm-bridge-start
|
||||
etc/sysadm.conf.dist
|
||||
etc/init.d/sysadm
|
||||
etc/init.d/sysadm-bridge
|
||||
etc/init.d/sysadm-rest
|
||||
etc/rc.d/sysadm
|
||||
etc/rc.d/sysadm-bridge
|
||||
etc/rc.d/sysadm-rest
|
||||
|
||||
@@ -1,13 +0,0 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
command="/usr/local/bin/sysadm-server"
|
||||
command_args=""
|
||||
pid=/var/run/sysadm.pid
|
||||
name="SysAdm Server (WebSocket)"
|
||||
|
||||
depend() {
|
||||
need syscons network
|
||||
after bootmisc
|
||||
}
|
||||
@@ -1,13 +0,0 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
command="/usr/local/bin/sysadm-bridge"
|
||||
command_args=""
|
||||
pid=/var/run/sysadm-bridge.pid
|
||||
name="SysAdm Bridge"
|
||||
|
||||
depend() {
|
||||
need syscons network
|
||||
after bootmisc
|
||||
}
|
||||
@@ -1,13 +0,0 @@
|
||||
#!/sbin/openrc-run
|
||||
# Copyright (c) 2016 Ken Moore <ken@ixsystems.com>
|
||||
# Released under the 2-clause BSD license
|
||||
|
||||
command="/usr/local/bin/sysadm-server"
|
||||
command_args="-rest"
|
||||
pid=/var/run/sysadm-rest.pid
|
||||
name="SysAdm Server (REST)"
|
||||
|
||||
depend() {
|
||||
need syscons network
|
||||
after bootmisc
|
||||
}
|
||||
@@ -331,11 +331,7 @@ QJsonArray PKG::list_categories(QString repo){
|
||||
QJsonArray PKG::list_repos(bool updated){
|
||||
QString dbdir = "/var/db/pkg/repo-%1.sqlite";
|
||||
QDir confdir("/usr/local/etc/pkg/repos");
|
||||
QStringList confs = confdir.entryList(QStringList() << "*.conf", QDir::Files);
|
||||
if(confs.isEmpty() && !updated){
|
||||
QProcess::execute("pkg update"); //need to update pkg configs
|
||||
return list_repos(true); //try again recursively (will not try to update again)
|
||||
}
|
||||
QStringList confs = confdir.entryList(QStringList() << "*.conf", QDir::Files);
|
||||
QStringList found;
|
||||
found << "local"; //There is always a local database (for installed pkgs)
|
||||
for(int i=0; i<confs.length(); i++){
|
||||
@@ -345,6 +341,11 @@ QJsonArray PKG::list_repos(bool updated){
|
||||
if(QFile::exists(dbdir.arg(repo)) && repoinfo[j].section("enabled:",1,-1).section(":",0,0).contains("true")){ found << repo; }
|
||||
}
|
||||
}
|
||||
if(found.length()<2 && !updated){
|
||||
//Only the local repo could be found - update the package repos and try again
|
||||
QProcess::execute("pkg update");
|
||||
return list_repos(true); //try again recursively (will not try to update again)
|
||||
}
|
||||
return QJsonArray::fromStringList(found);
|
||||
}
|
||||
|
||||
|
||||
@@ -9,6 +9,7 @@ ServiceManager::ServiceManager(QString chroot, QString ip)
|
||||
{
|
||||
this->chroot = chroot;
|
||||
this->ip = ip;
|
||||
loadRCdata();
|
||||
//loadServices();
|
||||
}
|
||||
|
||||
@@ -31,11 +32,12 @@ QList<Service> ServiceManager::GetServices()
|
||||
return services;
|
||||
}
|
||||
|
||||
// look at rcdata now
|
||||
QList<bool> ServiceManager::isRunning(QList<Service> services){
|
||||
//return list in the same order as the input list
|
||||
QList<bool> out;
|
||||
for(int i=0; i<services.length(); i++){
|
||||
if(services[i].Directory.isEmpty()){ out << false; }
|
||||
if(!rcdata.contains(services[i].Name)){ out << false; }
|
||||
else{ out << sysadm::General::RunQuickCommand("service",QStringList() << services[i].Directory << "status"); }
|
||||
}
|
||||
return out;
|
||||
@@ -47,14 +49,14 @@ bool ServiceManager::isRunning(Service service){ //single-item overload
|
||||
else{ return false; }
|
||||
}
|
||||
|
||||
// see if service is in rcdata and not in unuseddata
|
||||
QList<bool> ServiceManager::isEnabled(QList<Service> services){
|
||||
//return list in the same order as the input list
|
||||
QList<bool> out;
|
||||
loadRCdata();
|
||||
//Now go through the list of services and report which ones are enabled
|
||||
for(int i=0; i<services.length(); i++){
|
||||
bool enabled = false;
|
||||
if(rcdata.contains(services[i].Tag)){ enabled = rcdata.value(services[i].Tag)=="YES"; }
|
||||
enabled = (rcdata.contains(services[i].Name) && !unuseddata.contains(services[i].Name));
|
||||
out << enabled;
|
||||
}
|
||||
return out;
|
||||
@@ -66,6 +68,7 @@ bool ServiceManager::isEnabled(Service service){ //single-item overload
|
||||
else{ return false; }
|
||||
}
|
||||
|
||||
// onestart doesn't matter anymore
|
||||
bool ServiceManager::Start(Service service)
|
||||
{
|
||||
if(service.Directory.isEmpty()){ return false; }
|
||||
@@ -84,6 +87,7 @@ bool ServiceManager::Start(Service service)
|
||||
return General::RunQuickCommand(prog,args);
|
||||
}
|
||||
|
||||
// onestop doesn't matter anymore
|
||||
bool ServiceManager::Stop(Service service)
|
||||
{
|
||||
if(service.Directory.isEmpty()){ return false; }
|
||||
@@ -119,26 +123,36 @@ bool ServiceManager::Restart(Service service)
|
||||
return General::RunQuickCommand(prog,args);
|
||||
}
|
||||
|
||||
// Enable is rc-update add name runlevel
|
||||
bool ServiceManager::Enable(Service service)
|
||||
{
|
||||
if(service.Tag.isEmpty()){ return false; }
|
||||
return General::setConfFileValue( chroot + "/etc/rc.conf", service.Tag, service.Tag + "=\"YES\"", -1);
|
||||
if(!rcdata.contains(service.Name)){ return false; }
|
||||
return enableDisableService(service.Name, true);
|
||||
}
|
||||
|
||||
// Disable is rc-update del name runlevel
|
||||
bool ServiceManager::Disable(Service service)
|
||||
{
|
||||
if(service.Tag.isEmpty()){ return false; }
|
||||
return General::setConfFileValue( chroot + "/etc/rc.conf", service.Tag, service.Tag + "=\"NO\"", -1);
|
||||
if(!rcdata.contains(service.Name)){ return false; }
|
||||
return enableDisableService(service.Name, false);
|
||||
}
|
||||
|
||||
// get list of files from /etc/init.d and /usr/local/etc/init.d
|
||||
// Service::Name is pure filename
|
||||
// Service::Tag is nto used anymore
|
||||
// Service::Description is from file "name=", "desc=", "description="
|
||||
// rc-status --nocolor --servicelist indicates "isRunning"
|
||||
// rc-status --nocolor --unused indicates services not enabled
|
||||
//
|
||||
Service ServiceManager::loadServices(QString name)
|
||||
{
|
||||
QString tmp;
|
||||
bool valid;
|
||||
Service service;
|
||||
|
||||
// OpenRC directories are /etc/init.d and /usr/local/etc/init.d
|
||||
QStringList stringDirs;
|
||||
stringDirs << chroot + "/etc/rc.d" << chroot + "/usr/local/etc/rc.d";
|
||||
stringDirs << chroot + "/etc/init.d" << chroot + "/usr/local/etc/init.d";
|
||||
|
||||
for ( QString dir: stringDirs)
|
||||
{
|
||||
@@ -159,7 +173,8 @@ Service ServiceManager::loadServices(QString name)
|
||||
QFile file( dir + "/" + directory[i] );
|
||||
if ( file.open( QIODevice::ReadOnly ) )
|
||||
{
|
||||
valid=false;
|
||||
valid=true; //false;
|
||||
service.Name = directory[i]; // filename is the service name now
|
||||
service.Directory=directory[i]; //filename only
|
||||
service.Path = dir+"/"+directory[i]; //full path w/ filename
|
||||
QTextStream stream( &file );
|
||||
@@ -169,51 +184,20 @@ Service ServiceManager::loadServices(QString name)
|
||||
{
|
||||
line = stream.readLine(); // line of text excluding '\n'
|
||||
|
||||
if ( line.indexOf("name=") == 0)
|
||||
{
|
||||
valid=true;
|
||||
tmp = line.replace("name=", "");
|
||||
service.Name = tmp.replace('"', "");
|
||||
}
|
||||
if ( line.indexOf("rcvar=") == 0)
|
||||
{
|
||||
if ( tmp.isEmpty() )
|
||||
continue;
|
||||
|
||||
tmp = line.replace("rcvar=", "");
|
||||
tmp = tmp.replace('"', "");
|
||||
tmp = tmp.replace("'", "");
|
||||
tmp = tmp.replace("`", "");
|
||||
tmp = tmp.replace("$(set_rcvar)", "");
|
||||
tmp = tmp.replace("$set_rcvar", "");
|
||||
tmp = tmp.replace("set_rcvar", "");
|
||||
tmp = tmp.replace("${name}", "");
|
||||
tmp = tmp.replace("_enable", "");
|
||||
tmp = tmp.replace(" ", "");
|
||||
|
||||
if (tmp.isEmpty())
|
||||
service.Tag = service.Name + "_enable";
|
||||
else
|
||||
service.Tag = tmp;
|
||||
|
||||
if ( service.Tag.indexOf("_enable") == -1 )
|
||||
service.Tag=service.Tag + "_enable";
|
||||
break;
|
||||
}
|
||||
if (line.simplified().startsWith("desc=")) {
|
||||
if (line.simplified().startsWith("description=") ||
|
||||
line.simplified().startsWith("desc=") ||
|
||||
line.simplified().startsWith("name=")) {
|
||||
service.Description = line.section("=\"",1,-1).section("\"",0,0);
|
||||
}
|
||||
}
|
||||
file.close();
|
||||
|
||||
if ( !valid || service.Tag.isEmpty() )
|
||||
if ( !valid )
|
||||
continue;
|
||||
|
||||
QString cDir = dir;
|
||||
if ( ! chroot.isEmpty() )
|
||||
cDir.replace(chroot, "");
|
||||
if ( service.Tag.indexOf("$") == 0 )
|
||||
service.Tag = service.Directory + "_enable";
|
||||
if ( service.Name.indexOf("$") == 0 )
|
||||
service.Name = service.Directory;
|
||||
if(!name.isEmpty() ){ return service; } //found the requested service - return it
|
||||
@@ -222,16 +206,78 @@ Service ServiceManager::loadServices(QString name)
|
||||
}
|
||||
}
|
||||
}
|
||||
loadRunlevels();
|
||||
return Service();
|
||||
}
|
||||
|
||||
// rc-status --nocolor --servicelist to get all services
|
||||
void ServiceManager::loadRCdata(){
|
||||
//Read all the rc.conf files in highest-priority order
|
||||
rcdata.clear();
|
||||
QStringList info = sysadm::General::RunCommand("sysrc -A").split("\n");
|
||||
// output is spNAMEsp...[spSTATUSsp]\n
|
||||
QStringList info = sysadm::General::RunCommand("rc-status --nocolor --servicelist").split("\n");
|
||||
for(int i=0; i<info.length(); i++){
|
||||
if(info[i].contains(": ")){
|
||||
rcdata.insert( info[i].section(": ",0,0), info[i].section(": ",1,-1) );
|
||||
if (info[i].length()){
|
||||
QString name = info[i].section(" ",0,0,QString::SectionSkipEmpty);
|
||||
QString status = info[i].section(" ",-2,-2,QString::SectionSkipEmpty);
|
||||
rcdata.insert( name, status);
|
||||
//qDebug() << "load rc data " << name << " status " << status;
|
||||
}
|
||||
}
|
||||
loadUnusedData();
|
||||
}
|
||||
|
||||
// rc-status --nocolor --unused to find services not in any runlevel
|
||||
void ServiceManager::loadUnusedData() {
|
||||
//Read all the rc.conf files in highest-priority order
|
||||
unuseddata.clear();
|
||||
// output is spNAMEsp...[spSTATUSsp]\n
|
||||
// with runlevel lines mixed
|
||||
QStringList info = sysadm::General::RunCommand("rc-status --nocolor --unused").split("\n");
|
||||
for(int i=0; i<info.length(); i++){
|
||||
if (info[i].length()){
|
||||
QString name = info[i].section(" ",0,0,QString::SectionSkipEmpty);
|
||||
QString status = info[i].section(" ",-2,-2,QString::SectionSkipEmpty);
|
||||
unuseddata.insert( name, status);
|
||||
//qDebug() << "load unused data " << name << " status " << status;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// get the services enabled for all runlevels so we can update services
|
||||
void ServiceManager::loadRunlevels() {
|
||||
QStringList info = sysadm::General::RunCommand("rc-status --nocolor --all").split("\n");
|
||||
QString runlevel = "default";
|
||||
for (int i=0; i<info.length(); i++) {
|
||||
if (info[i].contains("Runlevel")) {
|
||||
runlevel = info[i].section(": ", -1,-1);
|
||||
continue;
|
||||
}
|
||||
QString name = info[i].section(" ",0,0,QString::SectionSkipEmpty);
|
||||
// search services for name and update runlevel
|
||||
for (int j=0; j < services.length(); j++){
|
||||
if (services[j].Name == name) {
|
||||
services[j].Runlevel = runlevel;
|
||||
//qDebug() << "Updating " << services[j].Name << " runlevel " << runlevel;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
bool ServiceManager::enableDisableService(QString name, bool enable) {
|
||||
QString runlevel = "default";
|
||||
// look in services for name, see if there is a runlevel set
|
||||
// if not, use default
|
||||
QString prog = "rc-update";
|
||||
QStringList args;
|
||||
if (enable)
|
||||
args << "add";
|
||||
else
|
||||
args << "delete";
|
||||
|
||||
args << name;
|
||||
args << runlevel;
|
||||
qDebug() << prog << " " << args;
|
||||
bool ret = sysadm::General::RunQuickCommand(prog,args);
|
||||
loadUnusedData();
|
||||
return ret;
|
||||
}
|
||||
|
||||
@@ -12,6 +12,9 @@ struct Service{
|
||||
Name = "";
|
||||
Tag = "";
|
||||
Directory = "";
|
||||
Path = "";
|
||||
Description = "";
|
||||
Runlevel = "";
|
||||
}
|
||||
|
||||
QString Name;
|
||||
@@ -19,6 +22,7 @@ struct Service{
|
||||
QString Directory;
|
||||
QString Path;
|
||||
QString Description;
|
||||
QString Runlevel;
|
||||
};
|
||||
|
||||
class ServiceManager
|
||||
@@ -79,9 +83,16 @@ private:
|
||||
QList<Service> services;
|
||||
Service loadServices(QString service = ""); //Return struct is optional - only used for a single service search
|
||||
|
||||
QHash<QString, QString> rcdata; //rc.conf settings
|
||||
QHash<QString, QString> rcdata; //output of rc-status
|
||||
void loadRCdata();
|
||||
|
||||
QHash<QString, QString> unuseddata;
|
||||
void loadUnusedData();
|
||||
|
||||
void loadRunlevels();
|
||||
|
||||
bool enableDisableService(QString name, bool enable=false);
|
||||
|
||||
QString chroot;
|
||||
QString ip;
|
||||
};
|
||||
|
||||
@@ -92,10 +92,12 @@ bool UserManager::addUser(QJsonObject* out, QJsonObject obj){
|
||||
QString dev = obj.value("personacrypt_init").toString();
|
||||
if(dev.startsWith("/dev/")){ dev = dev.remove(0,5); }
|
||||
//Verify that the given device is valid
|
||||
QStringList valid = getAvailablePersonaCryptDevices();
|
||||
for(int i=0; i<valid.length(); i++){
|
||||
if(valid[i].startsWith(dev+": ")){ PCdev = dev; } //this is a valid device
|
||||
}
|
||||
if(dev!="PEFS"){
|
||||
QStringList valid = getAvailablePersonaCryptDevices();
|
||||
for(int i=0; i<valid.length(); i++){
|
||||
if(valid[i].startsWith(dev+": ")){ PCdev = dev; } //this is a valid device
|
||||
}
|
||||
}else{ PCdev = dev; } //PEFS device
|
||||
if(PCdev!=dev){ return false; } //invalid inputs - invalid device for PersonaCrypt
|
||||
}
|
||||
QTemporaryFile pwfile("/tmp/.XXXXXXXXXXXXXXX");
|
||||
@@ -169,10 +171,12 @@ bool UserManager::modifyUser(QJsonObject* out, QJsonObject obj){
|
||||
QString dev = obj.value("personacrypt_init").toString();
|
||||
if(dev.startsWith("/dev/")){ dev = dev.remove(0,5); }
|
||||
//Verify that the given device is valid
|
||||
QStringList valid = getAvailablePersonaCryptDevices();
|
||||
for(int i=0; i<valid.length(); i++){
|
||||
if(valid[i].startsWith(dev+": ")){ PCdev = dev; } //this is a valid device
|
||||
}
|
||||
if(dev!="PEFS"){
|
||||
QStringList valid = getAvailablePersonaCryptDevices();
|
||||
for(int i=0; i<valid.length(); i++){
|
||||
if(valid[i].startsWith(dev+": ")){ PCdev = dev; } //this is a valid device
|
||||
}
|
||||
}else{ PCdev = dev; } //PEFS device
|
||||
if(PCdev!=dev){ return false; } //invalid inputs - invalid device for PersonaCrypt
|
||||
}
|
||||
//Now start assembling the external command
|
||||
|
||||
@@ -6,9 +6,6 @@ SUBDIRS+= server bridge
|
||||
rcd.path = /usr/local/etc/rc.d/
|
||||
rcd.files = rc.d/sysadm rc.d/sysadm-rest rc.d/sysadm-bridge
|
||||
|
||||
openrc.path = /usr/local/etc/init.d
|
||||
openrc.files = init.d/sysadm init.d/sysadm-rest init.d/sysadm-bridge
|
||||
|
||||
#dconf.path = /usr/local/etc/job.d/
|
||||
#dconf.extra = cp job.d/* $(INSTALL_ROOT)/usr/local/etc/job.d/
|
||||
|
||||
@@ -21,4 +18,4 @@ openrc.files = init.d/sysadm init.d/sysadm-rest init.d/sysadm-bridge
|
||||
conf.path = /usr/local/etc/
|
||||
conf.extra = cp conf/sysadm.conf ${INSTALL_ROOT}/usr/local/etc/sysadm.conf.dist
|
||||
|
||||
INSTALLS += rcd openrc conf
|
||||
INSTALLS += rcd conf
|
||||
|
||||
Reference in New Issue
Block a user