# Yugabyte yb-controller-server file not found in paths

**URL:** <https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433>\
**Category:** General\
**Created:** [May 15, 2025, 7:33am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433 "2025-05-15T07:33:22Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 15, 2025, 7:33am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/1 "2025-05-15T07:33:22Z")

</div>

I wanted to try xCluster Replication with YugabyteDB.

> **[Set up transactional xCluster](https://docs.yugabyte.com/preview/deploy/multi-dc/async-replication/async-transactional-setup-automatic/)**
>
> Setting up transactional (active-active single-master) replication between two YB universes

If you try to start a cluster using the `--backup_daemon=true` option while looking at the documentation, the following message is displayed and the cluster cannot be created.  
I expanded yugabyte-2.25.1.0-b381-linux-x86\_64.tar.gz and looked at the binary, but there seems to be no directory called ybc/bin in tarball.

Where can I find ybc/bin?  
Should I expand and use the binary below the share directory?

```auto
$ sudo yugabyted start --advertise_address=172.17.28.47 --base_dir=/home/yugabyte/data --backup_daemon=true
Starting yugabyted...
✅ System checks
✅ YugabyteDB Started                  
Yugabyte yb-controller-server file not found in paths ['/opt/yugabyte/yugabyte-2.25.1.0/ybc/bin']. Please check the paths.

```

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 15, 2025, 7:50am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/2 "2025-05-15T07:50:19Z")

</div>

> [@ytooyama](#):
>
> `/opt/yugabyte/yugabyte-2.25.1.0/ybc/bin`

The current workaround was to expand the ybc of the shared directory and pass the path.

```shell
cd yugabyte-2.25.1.0/share/
mkdir -p ybc 
tar -zvxf /opt/yugabyte/latest/share/ybc-2.0.0.0-b19-linux-x86_64.tar.gz -C ybc --strip-components 1
sudo mv ./ybc /opt/yugabyte/yugabyte-2.25.1.0/

```

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 15, 2025, 8:11am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/3 "2025-05-15T08:11:50Z")

</div>

I get this error, how can I get this command through?

```auto
$ sudo yugabyted xcluster create_checkpoint \
    --replication_id my_xcluster_repl \
    --databases testdb
Error: ysqlsh: error: connection to server at "localhost" (::1), port 5433 failed: Connection refused
	Is the server running on that host and accepting TCP/IP connections?
connection to server at "localhost" (127.0.0.1), port 5433 failed: Connection refused
	Is the server running on that host and accepting TCP/IP connections?

```

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 15, 2025, 8:24am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/4 "2025-05-15T08:24:32Z")

</div>

Ok.  
To execute this command, it seems that the specified DB is created, that there is one table in that DB, and the specification of `--base_dir` is required. I want you to write it in the document.

```shell
sudo yugabyted xcluster create_checkpoint \
    --base_dir=/home/yugabyte/data \
    --replication_id my_xcluster_repl \
    --databases testdb

+---------------------------------------------------------------------------------------------------------------------------------------------+
| yugabyted |
+---------------------------------------------------------------------------------------------------------------------------------------------+
| Status : xCluster create checkpoint success. |
| Bootstrapping : Before running the xcluster setup command, Database `testdb` and schema needs to be applied on the target cluster. |
+---------------------------------------------------------------------------------------------------------------------------------------------+

```

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 15, 2025, 9:25am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/5 "2025-05-15T09:25:17Z")

</div>

I managed to run xCluster Replication.  
Thanks.

> <https://gist.github.com/ytooyama/e5568b5dcdbdb79d1039fed11d9dd0d8>

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 16, 2025, 4:25am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/6 "2025-05-16T04:25:56Z")

</div>

By the way, is there any reason why the ybc path is not going through?

---

<div class="post-metadata">

**Author:** ![dorian\_yugabyte](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.yugabyte.com/dorian_yugabyte/32/206_2.png) [@dorian\_yugabyte](https://forum.yugabyte.com/u/dorian_yugabyte)\
**Post date:** [May 16, 2025, 8:10am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/7 "2025-05-16T08:10:40Z")

</div>

I thought you fixed it previously?

Please specify on which part you’re stuck so we can proceed with troubleshooting steps.

> [@ytooyama](#):
>
> To execute this command, it seems that the specified DB is created, that there is one table in that DB, and the specification of `--base_dir` is required. I want you to write it in the document.

`--base_dir` is always required. It just has a default value. So when you create a cluster with non-default value on `--base_dir`, you should always set it.

Yes, we have to document this more clearly.

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 16, 2025, 8:57am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/8 "2025-05-16T08:57:26Z")

</div>

Thank you for your reply.

I set it up while looking at the following document. If I don’t understand, I asked Yugabyte Docs AI about options and advised that Yugabyte Docs AI also needs --base\_dir.

> **[Set up transactional xCluster](https://docs.yugabyte.com/preview/deploy/multi-dc/async-replication/async-transactional-setup-automatic/)**
>
> Setting up transactional (active-active single-master) replication between two YB universes

What does replication\_id specify, what is it, what is the retention option for, and what is the unit? I heard from Yugabyte Docs AI and found out that it was day. I found out that I had to specify a value of 1 or more to run it, but I didn’t understand what the retention period was.

If you look at the reference, it is written that if you want to use the --base\_dir case or backup or restore this time, you should expand the tarball in the separate share directory and copy the ybc binary.  
However, I thought that if it had been deployed to that path from the beginning at the time of packaging, it would be better without having to copy it manually.

> **[yugabyted reference](https://docs.yugabyte.com/preview/reference/configuration/yugabyted/)**
>
> Use yugabyted to deploy YugabyteDB clusters.

However, I also think it was not good that I didn’t look at the document well.  
It was difficult, but I am happy that I was able to get the xCluster replication of YugabyteDB to work properly.

---

<div class="post-metadata">

**Author:** ![dorian\_yugabyte](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.yugabyte.com/dorian_yugabyte/32/206_2.png) [@dorian\_yugabyte](https://forum.yugabyte.com/u/dorian_yugabyte)\
**Post date:** [May 16, 2025, 3:03pm UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/9 "2025-05-16T15:03:25Z")

</div>

> [@ytooyama](#):
>
> What does replication\_id specify, what is it

Either see the --help of the command or read the reference page at [https://docs.yugabyte.com/preview/reference/configuration/yugabyted/:](https://docs.yugabyte.com/preview/reference/configuration/yugabyted/:)

```auto
❯ ./bin/yugabyted xcluster create_checkpoint --help
......
Flags:
  --replication_id Unique string to assign to a replication.

```

> [@ytooyama](#):
>
> what is the retention option for, and what is the unit?

On the [reference page](https://docs.yugabyte.com/preview/reference/configuration/yugabyted/):

```auto
Specify the retention period in days for the snapshots, after which they will be automatically deleted, from the time they were created.

```

I created a pull request to fix the --help command too: [[docs] Better `yugabyted configure point_in_time_recovery --retention` help message by ddorian · Pull Request #27229 · yugabyte/yugabyte-db · GitHub](https://github.com/yugabyte/yugabyte-db/pull/27229)

> [@ytooyama](#):
>
> If you look at the reference, it is written that if you want to use the --base\_dir case or backup or restore this time, you should expand the tarball in the separate share directory and copy the ybc binary.  
> However, I thought that if it had been deployed to that path from the beginning at the time of packaging, it would be better without having to copy it manually.

That’s correct. The reason is that yb-controller is not currently open source but only free to use under the polyform license. I will ask internally for a way to make this easier to use.

---

<div class="post-metadata">

**Author:** ![ytooyama](https://avatars.discourse-cdn.com/v4/letter/y/82dd89/32.png) [@ytooyama](https://forum.yugabyte.com/u/ytooyama)\
**Post date:** [May 17, 2025, 1:40am UTC](https://forum.yugabyte.com/t/yugabyte-yb-controller-server-file-not-found-in-paths/4433/10 "2025-05-17T01:40:24Z")

</div>

Thank you very much. I was able to understand.
