---
name: "opal-restart"
section: "1"
platform: "linux"
package: "openmpi-checkpoint"
version: "1.6.5-9.1+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/opal-restart"
---

# opal-restart(1)

Restart a previously checkpointed sequential process using the Open PAL Checkpoint/Restart Service (CRS) Note: This should only be used by the user if the application being restarted is an OPAL-only application. If it is an Open RTE or Open MPI program their respective tools should be used.

## NAME

opal-restart - Restart a previously checkpointed sequential process using the Open PAL Checkpoint/Restart Service (CRS)

**Note**: This should only be used by the user if the application being  restarted is an OPAL-only application. If it is an Open RTE or Open MPI program their respective tools should be used.

## SYNOPSIS

**opal-restart** **\[ options \]** **\<SNAPSHOT HANDLE\>**

## Options

*opal-restart* will attempt to restart a previously checkpointed squential process from the snapshot handle reference returned by *opal\_checkpoint*.

- **\<SNAPSHOT HANDLE\>**

  The snapshot handle reference returned by *opal\_checkpoint*, used to restart the process. This is required to be the last argument to this command.

- **-h \| --help**

  Display help for this command

- **--fork**

  Fork off a new process, which is the restarted process. By default, the restarted process will replace *opal-restart* process.

- **-w \| --where**

  The location of the local snapshot reference.

- **-s \| --self**

  Restart this process using the *self* CRS component. This component is a special case, all other CRS components are automatically detected.

- **-v \| --verbose**

  Enable verbose output for debugging.

- **-gmca \| --gmca \<key\> \<value\>**

  Pass global MCA parameters that are applicable to all contexts. *\<key\>* is the parameter name; *\<value\>* is the parameter value.

- **-mca \| --mca \<key\> \<value\>**

  Send arguments to various MCA modules.

## DESCRIPTION

*opal-restart* can be invoked multiple, non-overlapping times. This allows the user to restart a previously running sequential process. See [opal\_crs(7)](/opal_crs/7.md) for more information about the CRS framework and components.

When using the *self* CRS component, the **\<FILENAME\>** argument is replaced by the name of the program to be restarted followed by any arguments that need to be passed to the program. For example, if under normal execution we would start our program "foo" as:

   **shell$** setenv OMPI\_MCA\_crs=self\
    **shell$** setenv OMPI\_MCA\_crs\_self\_prefix=my\_callback\_prefix\
    **shell$** ./foo arg1 arg2

To restart this process, we may only need to call:

   **shell$** opal-restart --self\
                        \-mca crs\_self\_prefix my\_callback\_prefix \\\
                        ./foo arg1 arg2

This will cause the "my\_callback\_prefix-restart" function to be called as soon as the program "foo" calls *OPAL\_INIT*. You do not have to call your program with the same argument set as before. There for we could have just as correctly called:

   **shell$** opal-restart --self \\\
                        \-mca crs\_self\_prefix my\_callback\_prefix \\\
                        ./foo arg3

This depends upon the behavior of the program "foo".

## SEE ALSO

  [opal-checkpoint(1)](/opal-checkpoint/1.md), [opal\_crs(7)](/opal_crs/7.md)