Installing, updating, and removing software
There are four main ways to install software on ArcaOS:
- WarpIN, the general purpose installer for OS/2
- Arca Noae Package Manager (ANPM), the graphical front end to YUM (Yellowdog Updater Modified)
- IBM Installer, an older package installer, or other application-specific installer
- Compressed archive files (zip, 7z, rar, exe, etc.)
Generally, software which is installed using a particular method may (and should) be updated or removed using the same method. That is to say, if WarpIN was used to install a package, then WarpIN should be used to uninstall the package, instead of randomly deleting files from a command prompt. Most uninstallers will properly handle the removal of various user-created INI files, system INI file entries and CONFIG.SYS parameters specific to the application being removed, and other cleanup.
Likewise, updating packages using the same method as the original install ensures that proper safeguards are followed and that no files are unnecessarily duplicated in the process. If a different version (or vendor’s packaging) for a given application is available, the recommended procedure is to uninstall the existing package first (using the original method used to install that version), and then the new package should be installed – following a reboot of the system.
Some packages are specifically designed not to be removed. Examples here include kernel updates and anything else which if removed may render the system non-bootable. Such packages should only be reinstalled or updated.
Some packages being updated advise to not install over an existing installation. In this case, the recommended procedure is to uninstall the existing package first (using the original method used to install that version), and then install the new package – following a reboot of the system.
Specific package manager guidelines
WarpIN may be found in the WarpIN folder located in Install/Remove in the Computer folder on the ArcaOS desktop. WarpIN packages are provided either as .WPI (WarpIN Installer) files or .EXE (self-extracting WarpIN Installer files).
To install or update a WarpIN package, the easiest method is to open the Drives object in the Computer folder on the ArcaOS desktop (or the Drives object on the XCenter) and browse to the location of the desired package (.WPI or .EXE). The package will be displayed with a WarpIN icon for easy identification. Double-click the package to launch WarpIN in Install mode (or Add/Remove mode, if at least one of the components contained in the package is already installed). Follow the prompts to install, update, or add components.
To remove (“de-install” in WarpIN’s terminology) a package, start WarpIN directly from its object located in Computer | Install/Remove | WarpIN. This will launch WarpIN in Global database mode. Depending upon the View option selected in WarpIN, installed packages may be listed in Tree view (with “+” buttons available to the left of each package to expand the tree) in the Packages window or in Package detail view, with each package’s component listed on a separate line in the Packages window. Either select the package name (Tree view) with the left mouse button or each of the package’s components to be removed (by expanding the tree in Tree view and Ctrl-clicking each one, or by Ctrl-clicking each one in Package detail view. From WarpIN’s main menu, select Package | De-install package… and in the De-install Packages dialog, select file deletion and undo configuration options as desired. Finally, click OK in the De-install Packages dialog to begin the process.
WarpIN has help available from the main menu and by pressing F1.
ANPM may also be found in the Arca Noae Package Manager folder in Install/Remove in the Computer folder on the ArcaOS desktop. Currently, ANPM manages only RPM (Red Hat Package Manager) packages. RPMs are usually downloaded from a remote repository and installed upon successful download.
ANPM is a graphical front end to YUM, which itself is a dependency resolver and package downloader enhancement for RPM (and thus, RPM packages). As installed, ArcaOS configures the Netlabs stable repository for downloading new and updated packages. More repositories may be added. See the ANPM wiki or the online help for assistance in adding new repositories to your configuration.
To install an RPM, select it from the Available packages list, and from the main menu, select Selected | Install or click the “Install or update package to latest version” button on the toolbar. Follow the prompts to download and install the package.
To downgrade an already-installed package to an earlier version, select the installed package from the Installed packages list, and from the main menu, select Selected | Get specific release… Select the desired earlier release from the Select Version dialog and click Continue to downgrade the package.
To update a package, note the package’s icon. Packages with updates available have a distinct icon. Alternatively, set the package filter dropdown above the list to “Packages with updates” to list only those packages which may be updated. Select one or more packages for updating (Ctrl-click or Shift-click for a range of packages), and from the main menu, select Selected | Update or click the “Install or update package to latest version” button on the toolbar. Follow the prompts to download and update the package.
To uninstall a package, select one or more packages to be uninstalled (Ctrl-click or Shift-click for a range of packages), and from the main menu, select Selected | Uninstall or click the “Uninstall package” button on the toolbar. Follow the prompts to uninstall the package.
In addition to ANPM’s context-sensitive help, Arca Noae provides several wiki pages with helpful tips and procedures for using the tool.
The IBM Installer is application specific. If a given package includes this installer, the package itself is usually contained in some type of archive file (zip, 7z, rar, exe, etc.) or is on physical media of some type. The installer is usually named INSTALL.EXE. Simply run this to install the application. You may need to select various options as to which features you would like to install, the target location, etc. When complete, the application’s desktop folder should include an Uninstall object. Use this to launch the IBM Installer in uninstall mode to remove the application and/or change its features.
The IBM Installer is an IBM component separate and apart from ArcaOS. No direct support is provided for the IBM Installer by Arca Noae.
Various applications may be bundled with their own single-purpose installers. Like applications utilizing the IBM installer, these will usually be packaged in some type of archive file, and once unpacked, should contain something named INSTALL.EXE, INSTALL.CMD, SETUP.EXE, SETUP.CMD, or similar. Read the included documentation before launching any of these to understand what to expect (not all installers provide the ability to pause and read directions once they are launched).
Arca Noae does not provide direct support for application-specific installers, with rare exceptions. Check with the application developer or vendor for support with these components.
Compressed archive files (zip, 7z, rar, exe, etc.)
Often, the developer may not provide an actual install/uninstall utility for his application, and instead, may simply package the executable program and (hopefully) some documentation in a single, transportable archive.
ArcaOS provides Archive Tool to view the contents of these files and to extract them. Launch Archive Tool from Utilities in the Programs folder on the ArcaOS desktop. Open the archive either from the main menu by selecting File | Open or the “Open archive” button on the toolbar. Browse to the location of the archive, select it, and click OK. You may examine its content and even read included documentation from within Archive Tool.
When you are ready to extract the contents of the archive, select the top-level folder (usually recommended) and from the main menu select File | Extract files to… or click the “Extract files to” button on the toolbar. Select a suitable directory (or create one) from the Extract dialog, set other options as desired, and click Extract to begin the process.
Once the contents have been extracted, you may either access the files from the desktop by opening the folder (or the folder may have been opened for you – see the “Show destination folder after extracting” checkbox) or by opening a command prompt and navigating to it from the command line.
Support for Archive Tool is provided by the developer through Arca Noae’s ticketing system.
This entry last updated: by