Package Manager

Wikis > Package Manager

The Arca Noae Package Manager is a graphical interface to installing, removing, and updating software on your OS/2-based system. It is released under GPLv3, and is freely available to everyone.

This wiki page provides some tips and tricks for getting the most out of this utility. Also note our best practices sub-wiki.

Repositories

The table below shows the currently available repositories of OS/2 software known to us:

SourceNameRepoAuthentication
Required?
URIDescription
Arca NoaeStablearcanoae-relNohttps://repos.arcanoae.com/release/$releasever/stable (non-beta) packages
ArcaOSarcanoae-arcaosYeshttps://repos.arcanoae.com/arcaos/$releasever/stable packages; ArcaOS support & maintenance
subscription content
Subscriptionarcanoae-subYeshttps://repos.arcanoae.com/subscription/$releasever/stable packages; software & driver
subscription content
NetlabsStablenetlabs-relNohttp://rpm.netlabs.org/release/$releasever/$basearch/stable (non-beta) packages
Rosenthal & RosenthalStable (mirror)Nohttps://www.2rosenthals.com/rpm.netlabs.org/release/$releasever/$basearch/East Coast US mirror

Reminder

Arca Noae Package Manager may make changes to CONFIG.SYS when the path validation check is enabled (this is the default behavior). It is always good practice to maintain a recent backup of CONFIG.SYS (and other important system configuration files).

Prerequisites

  • OS/2 Warp 4 FixPak 13 or higher, eCS 1.x, 2.x, ArcaOS 5.x
  • 32-bit TCP/IP stack.
  • 150MB available space on local volume supporting long filenames and extended attributes to be designated as %UNIXROOT%.
  • WarpIN 1.0.19 or higher, available here.
  • kLIBC Pathrewriters, 1.0.2 or later, available here. Note that eCS version 2.x should already have the kLIBC Pathrewriters package installed. Look in your System Setup folder for the kLIBC Pathrewriters configuration object. If present, then this package is already installed. (ArcaOS 5.0 and above includes the updated and enhanced kLIBC Path Remapper which takes the place of the older kLIBC Pathrewriters.)

IMPORTANT: Systems with existing RPM & YUM which have not been updated recently (including fresh eCS installations)

Please review this page before running a YUM | Update all… operation for the first time or if you have an empty package list when Arca Noae Package Manager starts.

Initial setup of RPM & YUM

For systems with existing Python installations, please see this page.

On systems with no existing RPM & YUM installation, Arca Noae Package Manager should prompt to download and install the base package upon first program start. Once downloaded, you will be asked to select the drive to be designated as UNIXROOT, and the requisite directories and files will be placed under the root of that volume.

Upon completion of the extraction of this base package, CONFIG.SYS will be updated to reflect the necessary changes (a backup copy of CONFIG.SYS will be saved as CONFIG.YUM), and you will be prompted to reboot to have these new settings take effect.

Exit Arca Noae Package Manager, close any other running programs, and reboot. Upon returning to the desktop following the reboot, you may run Arca Noae Package Manager to check for updates and install new packages.

Known issues/limitations

The following issues with Arca Noae Package Manager are known to exist at this time:

  • In certain instances, upon installing the bootstrap package (usually, during the initial Arca Noae Package Manager setup), it will be necessary to add some packages to enable existing installed applications to continue to function. A known example of this is the libicu-legacy package which is required for Apache OpenOffice (see related information on path validation, below). Watch for a dedicated wiki page for this.
  • Filtering the available package list by repository may fail to display the latest version of a package if a newer version is available from another repository. Example:

Searching for ‘poppler-qt’ (not installed), perhaps version 0.31.0-1.oc00 is available on my-other-great-repo. Even though there are (older) versions available on netlabs-rel, these are not shown in the list of available packages.

If the filter drop-downs are used to show only packages from netlabs-rel, poppler-qt will no longer appear at all. This is because these filters are simply subsets of the already-queried data (and not new queries).

In this case, the only way to view versions of poppler-qt from netlabs-rel is to perform a search, which sends a new query to yum with the show-obsoletes flag set.

This is expected behavior.

  • The i386 architecture has been deprecated in favor of i686. As a result, packages which have been updated for the i686 and pentium4 architectures may not reflect the current version numbers in the available package list, although the icon may indicate that they have been updated recently. Selecting the listed package will always install the latest available for the configured architecture, however. As a workaround, start Arca Noae Package Manager with the /DUP switch. This will cause all available versions (duplicate package names, but all versions and architectures) to be displayed in the available package list. We are working on improving the package filtering logic to address this.
  • Some yum plugins may cause unpredictable results, as they might when running yum from the command line. These are either limitations of the plugins themselves or how they interact with other applications (namely, Python) on the OS/2 platform.
  • Management of secure repos excludes editing them. This capability is planned for a later release.
  • Changing architectures (i386 to i686, i386 to pentium4, pentium4 to i686, etc.) via editing of @unixroot\etc\rpm\platform may lead to unpredictable results. This is a yum issue, and not a defect of Arca Noae Package Manager. We are considering ways to help make these changes easier.
  • It is not possible to quickly scroll through lists of files by selecting the first letter of the package name. This is a standard system limitation for these types of windows; the scroll will stop on the first occurrence in any column of the letter pressed, not just the name.
  • Once an operation has started, there is no option to abort. This is intentional, as the idea is to never leave the system in an inconsistent state. Simply allow the operation to complete and then reverse the procedure to undo (e.g., install package A, then uninstall it).
  • Selecting more than one version of the same package for installation always results in the latest version being installed. If it is necessary to install an older version of a package, use the menu choice to install a specific version.
  • It is possible that in some circumstances, enabling the path validation check may cause other applications to stop working correctly. If this is the case for your system, simply disable the path validation check in the Preferences dialog and restore CONFIG.SYS from backup.
  • Inability to reach one or more enabled repositories results in no packages listed as available (refresh fails). This is a limitation of yum. Verify the repository configuration in the Repository Manager, and perhaps temporarily disable any non-responsive repositories (transient server or network errors could account for being unable to reach an otherwise-valid repository).
  • While it is possible to share the yum cache between multiple boot partitions, be careful to set the UNIXROOT environment variable appropriately for each partition. Arca Noae Package Manager will attempt to warn before downloading and (re)installing a yum/rpm configuration, but it is not possible to foresee every possible scenario.
  • If using a local yum repository, it must reside on the same volume as the one where Arca Noae Package Manager has been installed.
  • Currently, only rpm packages may be managed by Arca Noae Package Manager. A future release will add support for managing WarpIN archives and repositories.

Advanced techniques

Several methods are available to reduce bandwidth and latency as well as provide connection redundancy and load balancing. Here are some ideas:

Setting up a local repository

See the RPM How-To for end users on the  Netlabs RPM and YUM project page for assistance.

Connecting via a proxy server

To configure yum to connect to all repositories via a proxy server, edit %UNIXROOT%\etc\yum\yum.conf and add the following line in the [main] section:

proxy=<proxy-uri>

So, if running a local Squid cache with the default port configured, the proper entry would be:

proxy=http://localhost:3128

This will cause all configured repository connections to run through the proxy.

To configure yum to connect via a proxy server only for a specific repository, edit the repository (YUM | Repositories…)  and add the proxy= line to the desired .repo file. You may specify different proxies for different repositories in this manner. The setting in the .repo file overrides the global setting in yum.conf.

To disable the proxy for a given repository, edit the repository (YUM | Repositories…)  and add the following to the desired .repo file:

proxy=_none_

Currently, it is not possible to configure a per-repository proxy for secure repos. Look for proxy configuration options in a future release of Arca Noae Package Manager.

Troubleshooting

See the Troubleshooting page for assistance.

For System Builders and VARs

Arca Noae Package Manager supports custom branding to add your own logo and contact information to the Help | Product information panel. Contact Arca Noae for details.