---
name: "ocf_heartbeat_symlink"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_symlink"
---

# ocf\_heartbeat\_symlink(7)

Manages a symbolic link

## NAME

ocf\_heartbeat\_symlink - Manages a symbolic link

## SYNOPSIS

**symlink** \[start \| stop \| monitor \| meta-data \| validate-all\]

## DESCRIPTION

This resource agent that manages a symbolic link (symlink).

It is primarily intended to manage configuration files which should be enabled or disabled based on where the resource is running, such as cron job definitions and the like.

## SUPPORTED PARAMETERS

**link**

Full path of the symbolic link to be managed. This must obviously be in a filesystem that supports symbolic links.

(required, string, no default)

**target**

Full path to the link target (the file or directory which the symlink points to).

(required, string, no default)

**backup\_suffix**

A suffix to append to any files that the resource agent moves out of the way because they clash with "link".

If this is unset (the default), then the resource agent will simply refuse to create a symlink if it clashes with an existing file.

(optional, string, no default)

## SUPPORTED ACTIONS

This resource agent supports the following actions (operations):

**start**

Starts the resource. Suggested minimum timeout: 15s.

**stop**

Stops the resource. Suggested minimum timeout: 15s.

**monitor**

Performs a detailed status check. Suggested minimum timeout: 15s. Suggested interval: 60s.

**meta-data**

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

**validate-all**

Performs a validation of the resource configuration. Suggested minimum timeout: 10s.

## EXAMPLE CRM SHELL

The following is an example configuration for a symlink resource using the [**crm**(8)](/crm/8.md) shell:

```
primitive p_symlink ocf:heartbeat:symlink \
  params \
    link=string \
    target=string \
  op monitor depth="0" timeout="15s" interval="60s"
```

## EXAMPLE PCS

The following is an example configuration for a symlink resource using [**pcs**(8)](/pcs/8.md)

```
pcs resource create p_symlink ocf:heartbeat:symlink \
  link=string \
  target=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="15s" interval="60s"
```

## SEE ALSO

**http://clusterlabs.org/**

## AUTHOR

**ClusterLabs contributors (see the resource agent source for information about individual authors)**