Skip to content
Snippets Groups Projects
Commit 77d03816 authored by Bert Wesarg's avatar Bert Wesarg :keyboard:
Browse files

Update docs/software/vampir.md

parent dfb5beb0
No related branches found
No related tags found
3 merge requests!322Merge preview into main,!319Merge preview into main,!208Review Vampir
...@@ -8,15 +8,17 @@ graphical displays, including state diagrams, statistics, and timelines, can be ...@@ -8,15 +8,17 @@ graphical displays, including state diagrams, statistics, and timelines, can be
to obtain a better understanding of their parallel program inner working and to subsequently to obtain a better understanding of their parallel program inner working and to subsequently
optimize it. Vampir allows to focus on appropriate levels of detail, which allows the detection and optimize it. Vampir allows to focus on appropriate levels of detail, which allows the detection and
explanation of various performance bottlenecks such as load imbalances and communication explanation of various performance bottlenecks such as load imbalances and communication
deficiencies. [Follow this link for further deficiencies. Follow this
information](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir). [link](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir)
for further information.
A growing number of performance monitoring environments like [VampirTrace](../archive/vampir_trace.md), [Score-P](scorep.md) is the primary code instrumentation and run-time measurement framework for
Score-P, TAU or KOJAK can produce trace files that are readable by Vampir. The tool supports trace Vampir and supports various instrumentation methods, including instrumentation at source level and
files in Open Trace Format (OTF, OTF2) that is developed by ZIH and its partners and is especially at compile/link time. The tool supports trace files in Open Trace Format (OTF, OTF2) that is
designed for massively parallel programs. developed by ZIH and its partners and is especially designed for massively parallel programs.
\<img alt="" src="%ATTACHURLPATH%/vampir-framework.png" title="Vampir Framework" /> ![Vampir Framework](misc/vampir-framework.png)
{: align="center"}
## Starting Vampir ## Starting Vampir
...@@ -24,14 +26,14 @@ Prior to using Vampir you need to set up the correct environment on one ...@@ -24,14 +26,14 @@ Prior to using Vampir you need to set up the correct environment on one
the HPC systems with: the HPC systems with:
```Bash ```Bash
module load vampir module load Vampir
``` ```
For members of TU Dresden the Vampir tool is also available as For members of TU Dresden the Vampir tool is also available as
[download](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir/vampir_download_tu) [download](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir/vampir_download_tu)
for installation on your personal computer. for installation on your personal computer.
Make sure, that compressed display forwarding (e.g. `ssh -XC taurus.hrsk.tu-dresden.de`) is Make sure, that compressed display forwarding (e.g., `ssh -YC taurus.hrsk.tu-dresden.de`) is
enabled. Start the GUI by typing enabled. Start the GUI by typing
```Bash ```Bash
...@@ -47,15 +49,15 @@ for a tutorial on using the tool. ...@@ -47,15 +49,15 @@ for a tutorial on using the tool.
## Using VampirServer ## Using VampirServer
VampirServer provides additional scalable analysis capabilities to the Vampir GUI mentioned above. VampirServer provides additional scalable analysis capabilities to the Vampir GUI mentioned above.
To use VampirServer on the HPC resources of TU Dresden proceed as follows: start the Vampir GUI as To use VampirServer on the ZIH Systems proceed as follows: start the Vampir GUI as
described above and use the *Open Remote* dialog with the parameters indicated in the following described above and use the *Open Remote* dialog with the parameters indicated in the following
figure to start and connect a VampirServer instance running on taurus.hrsk.tu-dresden.de. Make sure figure to start and connect a VampirServer already instance running on the HPC system. Make sure
to fill in your personal ZIH login name. to fill in your personal ZIH login name.
\<img alt="" src="%ATTACHURLPATH%/vampir_open_remote_dialog.png" ![Vampir Open Remote dialog](misc/vampir-open-remote-dialog.png)
title="Vampir Open Remote Dialog" /> {: align="center"}
Click on the Connect button and wait until the connection is established. Enter your password when Click on the *Connect* button and wait until the connection is established. Enter your password when
requested. Depending on the available resources on the target system, this setup can take some time. requested. Depending on the available resources on the target system, this setup can take some time.
Please be patient and take a look at available resources beforehand. Please be patient and take a look at available resources beforehand.
...@@ -90,9 +92,8 @@ After scheduling this job the server prints out the port number it is serving on ...@@ -90,9 +92,8 @@ After scheduling this job the server prints out the port number it is serving on
Connecting to the most recently started server can be achieved by entering `auto-detect` as *Setup Connecting to the most recently started server can be achieved by entering `auto-detect` as *Setup
name* in the *Open Remote* dialog of Vampir. name* in the *Open Remote* dialog of Vampir.
\<img alt="" ![Vampir Open Remote Dialog (auto start)](misc/vampir-open-remote-dialog-auto-start.png)
src="%ATTACHURLPATH%/vampir_open_remote_dialog_auto_start.png" {: align="center"}
title="Vampir Open Remote Dialog" />
Please make sure you stop VampirServer after finishing your work with Please make sure you stop VampirServer after finishing your work with
the front-end or with the front-end or with
...@@ -107,9 +108,8 @@ Type ...@@ -107,9 +108,8 @@ Type
vampirserver help vampirserver help
``` ```
for further information. The [user manual of for further information. The [user manual](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir/dateien/VampirServer-User-Manual.pdf)
VampirServer](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/forschung/projekte/vampir/dateien/VampirServer-User-Manual.pdf) of VampirServer can be found at `doc/vampirserver-manual.pdf` in the installation directory.
can be found at *installation directory* /doc/vampirserver-manual.pdf.
Type Type
```Bash ```Bash
...@@ -123,10 +123,9 @@ to find the revision dependent *installation directory*. ...@@ -123,10 +123,9 @@ to find the revision dependent *installation directory*.
VampirServer listens to a given socket port. It is possible to forward VampirServer listens to a given socket port. It is possible to forward
this port (SSH tunnel) to a remote machine. This procedure is not this port (SSH tunnel) to a remote machine. This procedure is not
recommended and not needed at ZIH. However, the following example shows recommended and not needed at ZIH. However, the following example shows
the tunneling to a VampirServer on a compute node at Taurus. The same the tunneling to a VampirServer on a compute node.
procedure works on Venus.
Start VampirServer on Taurus and wait for its scheduling: Start VampirServer on the ZIH system and wait for its scheduling:
```Bash ```Bash
vampirserver start vampirserver start
...@@ -157,13 +156,12 @@ taurusi1253 of Taurus. Finally, start your local Vampir client and establish a r ...@@ -157,13 +156,12 @@ taurusi1253 of Taurus. Finally, start your local Vampir client and establish a r
Remark: Please substitute the ports given in this example with appropriate numbers and available Remark: Please substitute the ports given in this example with appropriate numbers and available
ports. ports.
### Nightly builds (unstable) ### Nightly Builds (unstable)
Expert users who subscribed to the development program can test new, unstable tool features. The Expert users who subscribed to the development program can test new, unstable tool features. The
corresponding Vampir and VampirServer software releases are provided as nightly builds. Unstable corresponding Vampir and VampirServer software releases are provided as nightly builds. Unstable
versions of VampirServer are also installed on the HPC systems. The most recent version can be versions of VampirServer are also installed on the HPC systems. The most recent version can be
launched/connected by entering `unstable` as *Setup name* in the *Open Remote* dialog of Vampir. launched/connected by entering `unstable` as *Setup name* in the *Open Remote* dialog of Vampir.
\<img alt="" ![Vampir Open Remote Dialog (unstable)](misc/vampir-open-remote-dialog-unstable.png)
src="%ATTACHURLPATH%/vampir_open_remote_dialog_unstable.png" {: align="center"}
title="Connecting to unstable VampirServer" />
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment