2007-03-17 02:11:45 +03:00
|
|
|
/*
|
A number of C/R enhancements per RFC below:
http://www.open-mpi.org/community/lists/devel/2010/07/8240.php
Documentation:
http://osl.iu.edu/research/ft/
Major Changes:
--------------
* Added C/R-enabled Debugging support.
Enabled with the --enable-crdebug flag. See the following website for more information:
http://osl.iu.edu/research/ft/crdebug/
* Added Stable Storage (SStore) framework for checkpoint storage
* 'central' component does a direct to central storage save
* 'stage' component stages checkpoints to central storage while the application continues execution.
* 'stage' supports offline compression of checkpoints before moving (sstore_stage_compress)
* 'stage' supports local caching of checkpoints to improve automatic recovery (sstore_stage_caching)
* Added Compression (compress) framework to support
* Add two new ErrMgr recovery policies
* {{{crmig}}} C/R Process Migration
* {{{autor}}} C/R Automatic Recovery
* Added the {{{ompi-migrate}}} command line tool to support the {{{crmig}}} ErrMgr component
* Added CR MPI Ext functions (enable them with {{{--enable-mpi-ext=cr}}} configure option)
* {{{OMPI_CR_Checkpoint}}} (Fixes trac:2342)
* {{{OMPI_CR_Restart}}}
* {{{OMPI_CR_Migrate}}} (may need some more work for mapping rules)
* {{{OMPI_CR_INC_register_callback}}} (Fixes trac:2192)
* {{{OMPI_CR_Quiesce_start}}}
* {{{OMPI_CR_Quiesce_checkpoint}}}
* {{{OMPI_CR_Quiesce_end}}}
* {{{OMPI_CR_self_register_checkpoint_callback}}}
* {{{OMPI_CR_self_register_restart_callback}}}
* {{{OMPI_CR_self_register_continue_callback}}}
* The ErrMgr predicted_fault() interface has been changed to take an opal_list_t of ErrMgr defined types. This will allow us to better support a wider range of fault prediction services in the future.
* Add a progress meter to:
* FileM rsh (filem_rsh_process_meter)
* SnapC full (snapc_full_progress_meter)
* SStore stage (sstore_stage_progress_meter)
* Added 2 new command line options to ompi-restart
* --showme : Display the full command line that would have been exec'ed.
* --mpirun_opts : Command line options to pass directly to mpirun. (Fixes trac:2413)
* Deprecated some MCA params:
* crs_base_snapshot_dir deprecated, use sstore_stage_local_snapshot_dir
* snapc_base_global_snapshot_dir deprecated, use sstore_base_global_snapshot_dir
* snapc_base_global_shared deprecated, use sstore_stage_global_is_shared
* snapc_base_store_in_place deprecated, replaced with different components of SStore
* snapc_base_global_snapshot_ref deprecated, use sstore_base_global_snapshot_ref
* snapc_base_establish_global_snapshot_dir deprecated, never well supported
* snapc_full_skip_filem deprecated, use sstore_stage_skip_filem
Minor Changes:
--------------
* Fixes trac:1924 : {{{ompi-restart}}} now recognizes path prefixed checkpoint handles and does the right thing.
* Fixes trac:2097 : {{{ompi-info}}} should now report all available CRS components
* Fixes trac:2161 : Manual checkpoint movement. A user can 'mv' a checkpoint directory from the original location to another and still restart from it.
* Fixes trac:2208 : Honor various TMPDIR varaibles instead of forcing {{{/tmp}}}
* Move {{{ompi_cr_continue_like_restart}}} to {{{orte_cr_continue_like_restart}}} to be more flexible in where this should be set.
* opal_crs_base_metadata_write* functions have been moved to SStore to support a wider range of metadata handling functionality.
* Cleanup the CRS framework and components to work with the SStore framework.
* Cleanup the SnapC framework and components to work with the SStore framework (cleans up these code paths considerably).
* Add 'quiesce' hook to CRCP for a future enhancement.
* We now require a BLCR version that supports {{{cr_request_file()}}} or {{{cr_request_checkpoint()}}} in order to make the code more maintainable. Note that {{{cr_request_file}}} has been deprecated since 0.7.0, so we prefer to use {{{cr_request_checkpoint()}}}.
* Add optional application level INC callbacks (registered through the CR MPI Ext interface).
* Increase the {{{opal_cr_thread_sleep_wait}}} parameter to 1000 microseconds to make the C/R thread less aggressive.
* {{{opal-restart}}} now looks for cache directories before falling back on stable storage when asked.
* {{{opal-restart}}} also support local decompression before restarting
* {{{orte-checkpoint}}} now uses the SStore framework to work with the metadata
* {{{orte-restart}}} now uses the SStore framework to work with the metadata
* Remove the {{{orte-restart}}} preload option. This was removed since the user only needs to select the 'stage' component in order to support this functionality.
* Since the '-am' parameter is saved in the metadata, {{{ompi-restart}}} no longer hard codes {{{-am ft-enable-cr}}}.
* Fix {{{hnp}}} ErrMgr so that if a previous component in the stack has 'fixed' the problem, then it should be skipped.
* Make sure to decrement the number of 'num_local_procs' in the orted when one goes away.
* odls now checks the SStore framework to see if it needs to load any checkpoint files before launching (to support 'stage'). This separates the SStore logic from the --preload-[binary|files] options.
* Add unique IDs to the named pipes established between the orted and the app in SnapC. This is to better support migration and automatic recovery activities.
* Improve the checks for 'already checkpointing' error path.
* A a recovery output timer, to show how long it takes to restart a job
* Do a better job of cleaning up the old session directory on restart.
* Add a local module to the autor and crmig ErrMgr components. These small modules prevent the 'orted' component from attempting a local recovery (Which does not work for MPI apps at the moment)
* Add a fix for bounding the checkpointable region between MPI_Init and MPI_Finalize.
This commit was SVN r23587.
The following Trac tickets were found above:
Ticket 1924 --> https://svn.open-mpi.org/trac/ompi/ticket/1924
Ticket 2097 --> https://svn.open-mpi.org/trac/ompi/ticket/2097
Ticket 2161 --> https://svn.open-mpi.org/trac/ompi/ticket/2161
Ticket 2192 --> https://svn.open-mpi.org/trac/ompi/ticket/2192
Ticket 2208 --> https://svn.open-mpi.org/trac/ompi/ticket/2208
Ticket 2342 --> https://svn.open-mpi.org/trac/ompi/ticket/2342
Ticket 2413 --> https://svn.open-mpi.org/trac/ompi/ticket/2413
2010-08-11 00:51:11 +04:00
|
|
|
* Copyright (c) 2004-2010 The Trustees of Indiana University.
|
2007-03-17 02:11:45 +03:00
|
|
|
* All rights reserved.
|
|
|
|
* Copyright (c) 2004-2005 The Trustees of the University of Tennessee.
|
|
|
|
* All rights reserved.
|
|
|
|
* Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
|
|
|
|
* University of Stuttgart. All rights reserved.
|
|
|
|
* Copyright (c) 2004-2005 The Regents of the University of California.
|
|
|
|
* All rights reserved.
|
|
|
|
* $COPYRIGHT$
|
|
|
|
*
|
|
|
|
* Additional copyrights may follow
|
|
|
|
*
|
|
|
|
* $HEADER$
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "ompi_config.h"
|
|
|
|
|
|
|
|
#include "opal/mca/mca.h"
|
2009-02-14 05:26:12 +03:00
|
|
|
#include "opal/util/output.h"
|
2007-03-17 02:11:45 +03:00
|
|
|
#include "opal/mca/base/base.h"
|
|
|
|
|
|
|
|
#include "ompi/mca/crcp/crcp.h"
|
|
|
|
#include "ompi/mca/crcp/base/base.h"
|
|
|
|
|
|
|
|
|
|
|
|
static ompi_crcp_base_component_t none_component = {
|
|
|
|
/* Handle the general mca_component_t struct containing
|
|
|
|
* meta information about the component itself
|
|
|
|
*/
|
|
|
|
{
|
2008-07-29 02:40:57 +04:00
|
|
|
OMPI_CRCP_BASE_VERSION_2_0_0,
|
|
|
|
|
2007-03-17 02:11:45 +03:00
|
|
|
/* Component name and version */
|
|
|
|
"none",
|
|
|
|
OMPI_MAJOR_VERSION,
|
|
|
|
OMPI_MINOR_VERSION,
|
|
|
|
OMPI_RELEASE_VERSION,
|
|
|
|
|
|
|
|
/* Component open and close functions */
|
|
|
|
ompi_crcp_base_none_open,
|
2008-05-06 22:08:45 +04:00
|
|
|
ompi_crcp_base_none_close,
|
|
|
|
ompi_crcp_base_none_query
|
2007-03-17 02:11:45 +03:00
|
|
|
},
|
|
|
|
{
|
2008-07-29 02:40:57 +04:00
|
|
|
/* Component is checkpointable */
|
|
|
|
MCA_BASE_METADATA_PARAM_CHECKPOINT
|
2007-03-17 02:11:45 +03:00
|
|
|
},
|
2008-05-06 22:08:45 +04:00
|
|
|
|
2007-03-17 02:11:45 +03:00
|
|
|
/* Verbosity level */
|
|
|
|
0,
|
2008-06-09 18:53:58 +04:00
|
|
|
/* opal_output handler */
|
2007-03-17 02:11:45 +03:00
|
|
|
-1,
|
|
|
|
/* Default priority */
|
|
|
|
1
|
|
|
|
};
|
|
|
|
|
|
|
|
static ompi_crcp_base_module_t none_module = {
|
|
|
|
/** Initialization Function */
|
|
|
|
ompi_crcp_base_module_init,
|
|
|
|
/** Finalization Function */
|
|
|
|
ompi_crcp_base_module_finalize,
|
|
|
|
|
A number of C/R enhancements per RFC below:
http://www.open-mpi.org/community/lists/devel/2010/07/8240.php
Documentation:
http://osl.iu.edu/research/ft/
Major Changes:
--------------
* Added C/R-enabled Debugging support.
Enabled with the --enable-crdebug flag. See the following website for more information:
http://osl.iu.edu/research/ft/crdebug/
* Added Stable Storage (SStore) framework for checkpoint storage
* 'central' component does a direct to central storage save
* 'stage' component stages checkpoints to central storage while the application continues execution.
* 'stage' supports offline compression of checkpoints before moving (sstore_stage_compress)
* 'stage' supports local caching of checkpoints to improve automatic recovery (sstore_stage_caching)
* Added Compression (compress) framework to support
* Add two new ErrMgr recovery policies
* {{{crmig}}} C/R Process Migration
* {{{autor}}} C/R Automatic Recovery
* Added the {{{ompi-migrate}}} command line tool to support the {{{crmig}}} ErrMgr component
* Added CR MPI Ext functions (enable them with {{{--enable-mpi-ext=cr}}} configure option)
* {{{OMPI_CR_Checkpoint}}} (Fixes trac:2342)
* {{{OMPI_CR_Restart}}}
* {{{OMPI_CR_Migrate}}} (may need some more work for mapping rules)
* {{{OMPI_CR_INC_register_callback}}} (Fixes trac:2192)
* {{{OMPI_CR_Quiesce_start}}}
* {{{OMPI_CR_Quiesce_checkpoint}}}
* {{{OMPI_CR_Quiesce_end}}}
* {{{OMPI_CR_self_register_checkpoint_callback}}}
* {{{OMPI_CR_self_register_restart_callback}}}
* {{{OMPI_CR_self_register_continue_callback}}}
* The ErrMgr predicted_fault() interface has been changed to take an opal_list_t of ErrMgr defined types. This will allow us to better support a wider range of fault prediction services in the future.
* Add a progress meter to:
* FileM rsh (filem_rsh_process_meter)
* SnapC full (snapc_full_progress_meter)
* SStore stage (sstore_stage_progress_meter)
* Added 2 new command line options to ompi-restart
* --showme : Display the full command line that would have been exec'ed.
* --mpirun_opts : Command line options to pass directly to mpirun. (Fixes trac:2413)
* Deprecated some MCA params:
* crs_base_snapshot_dir deprecated, use sstore_stage_local_snapshot_dir
* snapc_base_global_snapshot_dir deprecated, use sstore_base_global_snapshot_dir
* snapc_base_global_shared deprecated, use sstore_stage_global_is_shared
* snapc_base_store_in_place deprecated, replaced with different components of SStore
* snapc_base_global_snapshot_ref deprecated, use sstore_base_global_snapshot_ref
* snapc_base_establish_global_snapshot_dir deprecated, never well supported
* snapc_full_skip_filem deprecated, use sstore_stage_skip_filem
Minor Changes:
--------------
* Fixes trac:1924 : {{{ompi-restart}}} now recognizes path prefixed checkpoint handles and does the right thing.
* Fixes trac:2097 : {{{ompi-info}}} should now report all available CRS components
* Fixes trac:2161 : Manual checkpoint movement. A user can 'mv' a checkpoint directory from the original location to another and still restart from it.
* Fixes trac:2208 : Honor various TMPDIR varaibles instead of forcing {{{/tmp}}}
* Move {{{ompi_cr_continue_like_restart}}} to {{{orte_cr_continue_like_restart}}} to be more flexible in where this should be set.
* opal_crs_base_metadata_write* functions have been moved to SStore to support a wider range of metadata handling functionality.
* Cleanup the CRS framework and components to work with the SStore framework.
* Cleanup the SnapC framework and components to work with the SStore framework (cleans up these code paths considerably).
* Add 'quiesce' hook to CRCP for a future enhancement.
* We now require a BLCR version that supports {{{cr_request_file()}}} or {{{cr_request_checkpoint()}}} in order to make the code more maintainable. Note that {{{cr_request_file}}} has been deprecated since 0.7.0, so we prefer to use {{{cr_request_checkpoint()}}}.
* Add optional application level INC callbacks (registered through the CR MPI Ext interface).
* Increase the {{{opal_cr_thread_sleep_wait}}} parameter to 1000 microseconds to make the C/R thread less aggressive.
* {{{opal-restart}}} now looks for cache directories before falling back on stable storage when asked.
* {{{opal-restart}}} also support local decompression before restarting
* {{{orte-checkpoint}}} now uses the SStore framework to work with the metadata
* {{{orte-restart}}} now uses the SStore framework to work with the metadata
* Remove the {{{orte-restart}}} preload option. This was removed since the user only needs to select the 'stage' component in order to support this functionality.
* Since the '-am' parameter is saved in the metadata, {{{ompi-restart}}} no longer hard codes {{{-am ft-enable-cr}}}.
* Fix {{{hnp}}} ErrMgr so that if a previous component in the stack has 'fixed' the problem, then it should be skipped.
* Make sure to decrement the number of 'num_local_procs' in the orted when one goes away.
* odls now checks the SStore framework to see if it needs to load any checkpoint files before launching (to support 'stage'). This separates the SStore logic from the --preload-[binary|files] options.
* Add unique IDs to the named pipes established between the orted and the app in SnapC. This is to better support migration and automatic recovery activities.
* Improve the checks for 'already checkpointing' error path.
* A a recovery output timer, to show how long it takes to restart a job
* Do a better job of cleaning up the old session directory on restart.
* Add a local module to the autor and crmig ErrMgr components. These small modules prevent the 'orted' component from attempting a local recovery (Which does not work for MPI apps at the moment)
* Add a fix for bounding the checkpointable region between MPI_Init and MPI_Finalize.
This commit was SVN r23587.
The following Trac tickets were found above:
Ticket 1924 --> https://svn.open-mpi.org/trac/ompi/ticket/1924
Ticket 2097 --> https://svn.open-mpi.org/trac/ompi/ticket/2097
Ticket 2161 --> https://svn.open-mpi.org/trac/ompi/ticket/2161
Ticket 2192 --> https://svn.open-mpi.org/trac/ompi/ticket/2192
Ticket 2208 --> https://svn.open-mpi.org/trac/ompi/ticket/2208
Ticket 2342 --> https://svn.open-mpi.org/trac/ompi/ticket/2342
Ticket 2413 --> https://svn.open-mpi.org/trac/ompi/ticket/2413
2010-08-11 00:51:11 +04:00
|
|
|
/** Quiesce interface */
|
|
|
|
ompi_crcp_base_none_quiesce_start,
|
|
|
|
ompi_crcp_base_none_quiesce_end,
|
|
|
|
|
2007-03-17 02:11:45 +03:00
|
|
|
/** PML Wrapper */
|
|
|
|
ompi_crcp_base_none_pml_enable,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_add_comm,
|
|
|
|
ompi_crcp_base_none_pml_del_comm,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_add_procs,
|
|
|
|
ompi_crcp_base_none_pml_del_procs,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_progress,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_iprobe,
|
|
|
|
ompi_crcp_base_none_pml_probe,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_isend_init,
|
|
|
|
ompi_crcp_base_none_pml_isend,
|
|
|
|
ompi_crcp_base_none_pml_send,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_irecv_init,
|
|
|
|
ompi_crcp_base_none_pml_irecv,
|
|
|
|
ompi_crcp_base_none_pml_recv,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_pml_dump,
|
|
|
|
ompi_crcp_base_none_pml_start,
|
|
|
|
ompi_crcp_base_none_pml_ft_event,
|
|
|
|
|
|
|
|
/** Request Wrapper */
|
|
|
|
ompi_crcp_base_none_request_complete,
|
|
|
|
|
|
|
|
/** BTL Wrapper */
|
|
|
|
ompi_crcp_base_none_btl_add_procs,
|
|
|
|
ompi_crcp_base_none_btl_del_procs,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_btl_register,
|
|
|
|
ompi_crcp_base_none_btl_finalize,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_btl_alloc,
|
|
|
|
ompi_crcp_base_none_btl_free,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_btl_prepare_src,
|
|
|
|
ompi_crcp_base_none_btl_prepare_dst,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_btl_send,
|
|
|
|
ompi_crcp_base_none_btl_put,
|
|
|
|
ompi_crcp_base_none_btl_get,
|
|
|
|
|
|
|
|
ompi_crcp_base_none_btl_dump,
|
|
|
|
ompi_crcp_base_none_btl_ft_event
|
|
|
|
};
|
|
|
|
|
|
|
|
int ompi_crcp_base_select(void)
|
|
|
|
{
|
2008-05-06 22:08:45 +04:00
|
|
|
int ret, exit_status = OMPI_SUCCESS;
|
|
|
|
ompi_crcp_base_component_t *best_component = NULL;
|
|
|
|
ompi_crcp_base_module_t *best_module = NULL;
|
2013-03-28 01:09:41 +04:00
|
|
|
const char *include_list = NULL;
|
|
|
|
const char **selection_value;
|
|
|
|
int var_id;
|
2008-05-06 22:08:45 +04:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Register the framework MCA param and look up include list
|
|
|
|
*/
|
2013-03-28 01:09:41 +04:00
|
|
|
var_id = mca_base_var_find("ompi", "crcp", NULL, NULL);
|
|
|
|
|
|
|
|
/* NTH: The old parameter code here set the selection to none if no file value
|
|
|
|
or environment value was set. This effectively means include_list is never NULL. */
|
|
|
|
selection_value = NULL;
|
|
|
|
(void) mca_base_var_get_value(var_id, &selection_value, NULL, NULL);
|
|
|
|
if (NULL == selection_value || NULL == selection_value[0]) {
|
|
|
|
(void) mca_base_var_set_value(var_id, "none", 5, MCA_BASE_VAR_SOURCE_DEFAULT, NULL);
|
|
|
|
include_list = "none";
|
|
|
|
} else {
|
|
|
|
include_list = selection_value[0];
|
|
|
|
}
|
2008-05-06 22:08:45 +04:00
|
|
|
|
2013-03-28 01:09:41 +04:00
|
|
|
if(0 == strncmp(include_list, "none", strlen("none")) ){
|
2013-03-28 01:17:31 +04:00
|
|
|
opal_output_verbose(10, ompi_crcp_base_framework.framework_output,
|
2008-05-06 22:08:45 +04:00
|
|
|
"crcp:select: Using %s component",
|
|
|
|
include_list);
|
|
|
|
best_component = &none_component;
|
|
|
|
best_module = &none_module;
|
|
|
|
/* JJH: Todo: Check if none is in the list */
|
|
|
|
/* Close all components since none will be used */
|
|
|
|
mca_base_components_close(0, /* Pass 0 to keep this from closing the output handle */
|
2013-03-28 01:17:31 +04:00
|
|
|
&ompi_crcp_base_framework.framework_components,
|
2008-05-06 22:08:45 +04:00
|
|
|
NULL);
|
|
|
|
goto skip_select;
|
2007-03-17 02:11:45 +03:00
|
|
|
}
|
2008-05-06 22:08:45 +04:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Select the best component
|
2007-03-17 02:11:45 +03:00
|
|
|
*/
|
2013-03-28 01:17:31 +04:00
|
|
|
if( OPAL_SUCCESS != mca_base_select("crcp", ompi_crcp_base_framework.framework_output,
|
|
|
|
&ompi_crcp_base_framework.framework_components,
|
2008-06-06 18:38:41 +04:00
|
|
|
(mca_base_module_t **) &best_module,
|
|
|
|
(mca_base_component_t **) &best_component) ) {
|
2008-05-06 22:08:45 +04:00
|
|
|
/* This will only happen if no component was selected */
|
|
|
|
exit_status = OMPI_ERROR;
|
|
|
|
goto cleanup;
|
2007-03-17 02:11:45 +03:00
|
|
|
}
|
|
|
|
|
2008-05-06 22:08:45 +04:00
|
|
|
skip_select:
|
2007-03-17 02:11:45 +03:00
|
|
|
/* Save the winner */
|
|
|
|
ompi_crcp_base_selected_component = *best_component;
|
|
|
|
ompi_crcp = *best_module;
|
|
|
|
|
|
|
|
/* Initialize the winner */
|
|
|
|
if (NULL != best_module) {
|
2008-06-06 18:38:41 +04:00
|
|
|
if (OPAL_SUCCESS != (ret = ompi_crcp.crcp_init()) ) {
|
|
|
|
exit_status = ret;
|
2008-05-06 22:08:45 +04:00
|
|
|
goto cleanup;
|
2007-03-17 02:11:45 +03:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2008-05-06 22:08:45 +04:00
|
|
|
cleanup:
|
|
|
|
|
|
|
|
return exit_status;
|
2007-03-17 02:11:45 +03:00
|
|
|
}
|