TrizTech/ohif-viewer
15
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Simplify spinning up orthanc

Browse Source
This commit is contained in:
dannyrb 2019-05-09 23:25:07 -04:00
parent 7617e23ee6
commit 450385391e
1 changed files with 29 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
docs/latest/essentials/data-source.md
View File

@ -1,66 +1,48 @@
# Data Source # Data Source
After following the steps outlined in [Getting Started](./getting-started.md) After following the steps outlined in [Getting Started](./getting-started.md),
you'll notice that the OHIF Viewer has data for several studies and their
images. You didn't add this data, so where is it coming from?
#### By default, the viewer is configured to connect to a remote server hosted by the
nice folks over at [dcmjs.org][dcmjs-org]. While convenient for getting started,
Note: This will connect to our public DICOMWeb server so you can verify your the time may come when you want to develop using your own data either locally or
installation. Follow the next section to connect to your own local or remote remotely.
DICOMWeb server.
## Set up a local DICOM server ## Set up a local DICOM server
> ATTENTION! Already have a remote or local server? Skip to the
> [configuration section](#) below.
While the OHIF Viewer can work with any data source, the easiest to configure
are the ones that follow the [DICOMWeb][dicom-web] spec.
1. Choose and install an Image Archive 1. Choose and install an Image Archive
2. Upload some data into your archive (e.g. with DCMTK's 2. Upload data to your archive (e.g. with DCMTK's [storescu][storescu] or your
[storescu](http://support.dcmtk.org/docs/storescu.html) or your archive's web archive's web interface)
interface)
3. Keep the server running 3. Keep the server running
#### Open Source DICOM Image Archive Options For our purposes, we will be using `Orthanc`, but you can see a list of
[other Open Source options](#open-source-dicom-image-archives) below.
### Requirements
...
#### Orthanc with Docker ### Running Orthanc
Depending on whether or not you want uploaded studies to persist in Orthanc ```bash
after Docker has been closed, there are two different methods for starting the # Runs orthanc so long as window remains open
Docker image: yarn run orthanc:up
##### Temporary data storage
This command will start an instance of the jodogne/orthanc-plugins Docker image.
_All data will be removed when the instance is stopped!_
```
docker run --rm -p 4242:4242 -p 8042:8042 jodogne/orthanc-plugins
``` ```
##### Persistent data storage After running this command, you can access
[Orthanc's web interface](http://127.0.0.1:8042) at `http://127.0.0.1:8042` to
upload DICOM files.
In order to allow your data to persist after the instance is stopped, you first You can see the `docker-compose.yml` file this command runs at
need to create an image and attached data volume with Docker. The steps are as `<project-root>/docker/Orthanc/`, and more on Orthanc for Docker in [Orthanc's
follows: documentation][orthanc-docker].
1. Create a persistent data volume for Orthanc to use
```
docker create --name sampledata -v /sampledata jodogne/orthanc-plugins
```
**Note: On Windows, you need to use an absolute path for the data volume,
like so:**
```
docker create --name sampledata -v '//C/Users/erik/sampledata' jodogne/orthanc-plugins
```
2. Run Orthanc from Docker with the data volume attached
```
docker run --volumes-from sampledata -p 4242:4242 -p 8042:8042 jodogne/orthanc-plugins
```
3. Upload your data and it will be persisted
### Setting up OHIF Viewer with Orthanc as an example ### Setting up OHIF Viewer with Orthanc as an example