Package Switch and Migration

Package Switch and Migration

Use this flow when replacing a standalone library with an EasyLibrary package.

Standalone To Package-Backed

1. Install the package while the standalone is still present.

/easylibrary packages install libplaceholder stable confirm
restart server

2. Confirm the package is shadowed by standalone.

/easylibrary packages doctor

3. Run the switch checklist.

/easylibrary packages switch libplaceholder
/easylibrary packages switch libplaceholder confirm

4. Stop the server.
5. Move the standalone PHAR or folder out of plugins/.
6. Start the server.
7. Validate.

/pl
/easylibrary packages doctor
/easylibrary doctor

Development-only probe:

/elprobe run libplaceholder

Package-Backed To Standalone

1. Park or remove the package proxy.
2. Stop the server.
3. Add the standalone PHAR.
4. Start the server.
5. Confirm standalone wins.

/easylibrary packages switch libplaceholder park
restart server
/easylibrary packages doctor

Rule

Switch one provider at a time. This keeps problems small and rollback obvious.