# HG changeset patch # User Sebastien Jodogne # Date 1723812179 -7200 # Node ID 0f1d221a4faf6813ef2805c894f4024bd630745c # Parent 4f3709b36f8ae536589c14a66ff7979763bfa38e minor improvements in quick-start-windows diff -r 4f3709b36f8a -r 0f1d221a4faf Sphinx/source/users/quick-start-windows.rst --- a/Sphinx/source/users/quick-start-windows.rst Fri Aug 16 10:50:55 2024 +0200 +++ b/Sphinx/source/users/quick-start-windows.rst Fri Aug 16 14:42:59 2024 +0200 @@ -1,16 +1,16 @@ .. _quick-start-windows: -Quickstart Guide for Windows +Quickstart guide for Windows ============================ -Orthanc is a lightweight, open-source DICOM server ideal for medical imaging professionals. This guide will help you quickly set up and run Orthanc on a Windows machine. +Orthanc is a lightweight, free and open-source DICOM server that is ideal for medical imaging professionals. This guide will help you to quickly set up and run Orthanc on a Microsoft Windows computer. Step 1: Download Orthanc ------------------------ 1. **Visit the Orthanc Website** - Navigate to the `Orthanc downloads website `_. + Navigate to the `Orthanc downloads for Microsoft Windows `__ Web site. 2. **Download the Windows Installer** @@ -20,8 +20,8 @@ ----------------------- 1. **Run the Installer** - Locate the downloaded installer file and double-click it to start the installation process. Note that the installer is not signed and you might - have to click on ``More info`` and ``Run anyway`` + + Locate the downloaded installer file on your computer. Double-click on it to start the installation process. Note that the installer is not signed and that you might have to click on ``More info`` and ``Run anyway``: .. image:: ../images/win-quick-start-protect.png :align: center @@ -30,41 +30,43 @@ 2. **Follow the Installation Wizard** * Accept the license agreement. -* Choose the installation directory (default ``C:\Program Files\Orthanc Server`` is usually fine). -* Select the folder in which Orthanc will store its data files (default ``C:\Orthanc`` is usually fine). -* Select the plugins to install. Although you might not need all of them, they are all selected by default and this is fine : plugins that are not explicitly enabled do not consume any resources. +* Choose the installation directory (default value ``C:\Program Files\Orthanc Server`` is usually fine). +* Select the folder in which Orthanc will store its data (default value ``C:\Orthanc`` is usually fine). +* Select the plugins to install. Although you might not need all of them, they are all selected by default and this is fine: Plugins that are not explicitly enabled do not consume any resources. * Complete the installation by following the prompts. .. image:: ../images/win-quick-start-inst.png :align: center :width: 40% -Step 3: Orthanc is running ! ----------------------------- +Step 3: Orthanc is running! +--------------------------- -At this stage, Orthanc is running as a Windows Service which means that it will start everytime your Windows machine starts. +At this stage, Orthanc is running as a Windows Service, which means that it will automatically start whenever your computer starts. -Orthanc User Interface is accessible at `http://localhost:8042/ui/app/ `_. Orthanc is currently empty +The :ref:`Orthanc Explorer 2 ` interface is accessible at `http://localhost:8042/ui/app/ `__. As Orthanc has not received any DICOM file yet, its content is currently empty: .. image:: ../images/win-quick-start-orthanc-empty.png :align: center :width: 80% -Step 4: Upload and view your first DICOM images ! -------------------------------------------------- +Step 4: Upload and view your first DICOM images! +------------------------------------------------ -The easiest way to feed Orthanc with DICOM images is through the ``upload`` menu of the User interface. +The easiest way to feed Orthanc with DICOM images is through the ``Upload`` menu of the Orthanc Explorer 2 interface: .. image:: ../images/win-quick-start-orthanc-upload.png :align: center :width: 40% -Once this is done, your DICOM images will appear in the Study List and you'll be able to browse them and visualize them with one of the pre-installed viewers. -Remember that we have installed all plugins ? Therefore, you'll have the choice between 4 viewers: +Once uploaded, your DICOM images will appear in the list of studies. You will be able to browse them and visualize them with one of the pre-installed viewers. +Remember that we have installed all plugins? Therefore, you have the choice between 4 viewers: -* The :ref:`Stone Web viewer ` -* The :ref:`OHIF viewer ` -* :ref:`Volview ` +* The :ref:`Stone Web viewer `, +* The :ref:`OHIF viewer `, +* The :ref:`Kitware VolView viewer `. + +Each of these viewers can easily be launched by clicking on the buttons highlighted in red: .. image:: ../images/win-quick-start-orthanc-study-list.png :align: center @@ -73,14 +75,14 @@ Step 5: Configure Orthanc ------------------------- -Orthanc is configured through a `JSON `__ configuration file and comes with a default configuration that is suitable for quick testing. -However, at some point, you might probably need to customize the settings. +Orthanc is configured using a `JSON `__ configuration file. The Windows installers come with a default configuration file that is suitable for quick testing. +However, at some point, you will probably want to customize the settings. 1. **Locate the Configuration Files** - The Windows configuration is split under multiple configuration files and are typically stored in ``C:\Program Files\Orthanc\Configuration\``. + The Windows configuration is split into multiple configuration files (one main configuration file, plus one for each plugin). These files are typically stored in ``C:\Program Files\Orthanc\Configuration\``. ``orthanc.json`` is the main configuration file. Its complete documentation is available `here `__. - Each :ref:`plugin ` has its own configuration file documented in the plugin documentation. + In addition, each :ref:`plugin ` has its own configuration file that is described in the documentation of the plugin. .. image:: ../images/win-quick-start-config-files.png :align: center @@ -88,40 +90,40 @@ 2. **Edit the Configuration File** - To edit a configuration file, you must start your editor with ``Run as administrator``. - We recommend to edit your configuration file with an editor such as `Notepad++ `_. - It shall warn you that this file can be edited only by an admin, and will suggest you to restart Notepad++ as an admin such that you'll be - able to save it. + To edit a configuration file, you must start your editor with ``Run as administrator``. + We recommend to edit your configuration file using an editor such as `Notepad++ `__. + It will warn you that this file can only be edited by an administrator and suggest that you restart Notepad++ as an administrator so that you will be able to save it. - Configure settings such as: + Some important configuration options are for instance: * **HTTP Server Port**: ``"HttpPort": 8042`` (default is 8042) * **DICOM Server Port**: ``"DicomPort": 4242`` (default is 4242) * **Database Storage Path**: ``"StorageDirectory": "OrthancStorage"`` + Save your changes. **Remark 1:** When specifying paths under Microsoft Windows, backslashes (i.e. ``\``) should be either escaped by doubling them (as in ``\\``), or replaced by forward slashes (as in ``/``). - **Remark 2:** In JSON, every ``{}`` and every ``,`` counts ! Orthanc will refuse to + **Remark 2:** In JSON, every ``{}`` and every ``,`` counts! Orthanc will refuse to start if the file is not in a valid JSON format. There are numerous online JSON validators to validate your JSON. 3. **Restart Orthanc service** - To take the configuration changes into account, Orthanc must be restarted. This is done through the - ``services`` panel (type the ``Windows`` key and search for ``services``). Locate Orthanc and right click ``Restart`` + To take the changes to the configuration files into account, Orthanc must be restarted. This is done through the + ``services`` panel of Microsoft Windows (type the ``Windows`` key and search for ``services``). Locate the Orthanc service, right click, and select ``Restart``: .. image:: ../images/win-quick-start-services.png :align: center :width: 70% -4. **Check it is running correctly** +4. **Check Orthanc is Running Correctly** - Open the User Interface at `http://localhost:8042/ui/app/ `_ to validate that Orthanc is running correctly after your changes. - If not, you should check the :ref:`Orthanc logs ` in ``C:\\Program Files\\Orthanc Server\\Logs``. + Open the user interface at `http://localhost:8042/ui/app/ `__ to validate that Orthanc is still running correctly after your changes. + If not, you should check the :ref:`Orthanc logs ` in the ``C:\Program Files\Orthanc Server\Logs\`` folder. Next steps @@ -130,8 +132,8 @@ Now that you know how to configure Orthanc, here are a few suggested sections to continue your exploration: * :ref:`Connect Orthanc to a DICOM modality ` -* Connect a DICOMWeb client e.g. :ref:`Osirix ` -* Learn to use the Orthanc Rest API :ref:`Rest API ` +* Connect a DICOMweb client such as :ref:`Osirix ` +* Learn to use the Orthanc :ref:`REST API ` * Start to customize Orthanc through :ref:`Lua scripting ` -* Extend Orthanc through a :ref:`Python plugin ` -* And learn much more by reading the :ref:`Orthanc book ` \ No newline at end of file +* Extend Orthanc using a :ref:`Python plugin ` +* And learn much more by reading the whole :ref:`Orthanc book `