02. Operations on repositories

Create a mirror repository

From the REPOS tab:

1. You must first add one or more source repos to mirror from. See Add a new source repository.
2. Click the Create a new repo button to show the CREATE A NEW REPO panel.
3. Select mirror as the repo type then complete all the required fields.
4. Confirm and execute.

Notes:

• Custom repo name field is optionnal, if none is specified then the mirror repository will have the same name as the source repository (e.g source repo is named nginx then the mirror repository will also be named nginx).

---

Create a local repository

From the REPOS tab:

1. Click the Create a new repo button to show the CREATE A NEW REPO panel.
2. Select local as the repo type then complete all the required fields.
3. Confirm and execute.

Notes:

• Local repositories are always empty when created, you must then add you own rpm or deb packages by uploading them. See Upload package(s) in a repository.

---

Update an existing mirror repository

From the REPOS tab:

1. Select one or more repository snapshot mirror.
2. Click the Update button.
3. Specify mirroring parameters.
4. Confirm and execute.

Notes:

• Only mirror repository can be updated.

---

Point an environment to a repository

From the REPOS tab:

1. Select one or more repository snapshot.
2. Click the Point an environment button.
3. Specify the environment that will point to the snapshot.
4. Confirm and execute.

---

Remove an environment from a repository

From the REPOS tab:

1. Click the icon next to the environment you want to remove.
2. Confirm by clicking the Delete button.

---

Duplicate a repository

From the REPOS tab:

1. Select the repository snapshot you want to duplicate.
2. Click the Duplicate button.
3. Specify the name of the new repository that will be created from the selected repository.
4. Confirm and execute.

---

Delete a repository snapshot

From the REPOS tab:

1. Select one or more repository snapshot mirror by checking its checkbox.
2. Choose Delete
3. Confirm and execute

---

Browse repository content

From the REPOS tab:

1. Locate the repository snapshot you want to explore. It can be either a local or a mirror repository.
2. Click on the date of the snapshot to browse its content.

---

Upload package(s) in a repository

From the REPOS tab:

1. Locate the repo snapshot date in which you want to upload package(s). It can be either a local or a mirror repository.
2. Click the icon under the date to explore repository's content.
3. Use the UPLOAD PACKAGES right panel to select and upload packages from your local PC. Valid packages MIME types are: 'application/x-rpm' (.rpm file) and 'application/vnd.debian.binary-package' (.deb file). The server will do a strict check to make sure packages are valid and are not corrupted. If so, an error message will display packages that have not been included to the repository.
4. To take the new package(s) into account and make them visible from clients, use the REBUILD REPO right panel to rebuild the repository's metadata.

Notes:

• If you encounter errors while uploading files to a repository, it might be caused by upload limitations from PHP or your webserver. Please consider increasing the following values:

• php.ini => upload_max_filesize (must be equal or higher than the file's size you're attempting to upload)
• nginx vhost => client_max_body_size (must be higher than the file's size you're attempting to upload)

• Be sure that the file MIME type is valid.

---

Delete package(s) from a repository

From the REPOS tab:

1. Locate the repo snapshot in which you want to delete package(s). It can be either a local or a mirror repository.
2. Click the icon under the date to explore repository's content.
3. Use the package dropdown list to search for the package(s) you need to delete, then use the checkbox to select them.
4. Use the Delete button to delete packages.
5. To take the changes into account, use the REBUILD REPO right panel to rebuild the repository's metadata.

---

Rebuild repository metadata

From the REPOS tab:

1. Locate the repository snapshot you wish to rebuild. It can be either a local or a mirror repository.
2. Click the Rebuild button.
3. Confirm and execute.

Install a repository on a client

Once a repository has been created, you can install it on a client to make it available for package installation.

From the REPOS tab:

1. Locate the repository snapshot environment you wish to install and pass your mouse over it to show the install icon .
2. Click the icon to print the installlation command lines.
3. Copy the command lines and paste them in your client terminal console.