Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oracle/solaris-ips
Solaris IPS: Image Packaging System
https://github.com/oracle/solaris-ips
solaris
Last synced: about 2 months ago
JSON representation
Solaris IPS: Image Packaging System
- Host: GitHub
- URL: https://github.com/oracle/solaris-ips
- Owner: oracle
- License: other
- Created: 2017-04-04T02:38:10.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-02T13:15:35.000Z (6 months ago)
- Last Synced: 2024-04-14T23:31:13.286Z (5 months ago)
- Topics: solaris
- Language: Python
- Homepage:
- Size: 135 MB
- Stars: 62
- Watchers: 28
- Forks: 24
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-CPIO
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-python-applications - Repo
- awesome-python-applications - Repo
README
# Solaris Image Packaging System
## Introduction
The Image Packaging System (IPS) is a software delivery system with interaction with a network repository as its primary design goal. Other key ideas are: safe execution for zones and other installation contexts, use of ZFS for efficiency and rollback, preventing the introduction of incorrect or incomplete packages, and efficient use of bandwidth.
## Prerequisites
IPS development requires additional external dependencies, which on Solaris 11 are provided by the list of packages found in src/pkg/external_deps.txt.
## Build, Testing and Deployment
Once all dependency packages are installed, IPS source can be built by the following command:
> $ cd src; make install
The above will generate a proto directory under the root directory. Inside the proto directory, the build\_i386 directory contains Python version-specific builds; root\_i386 contains the complete build with the directory structure preserved.
Generally, testing of the new build can be done by the following command:
> $cd src/tests; sudo ./run.py -j 8
The above will run all test cases in 8 parallel processes. Other options are also available by typing `./run.py -h.`
Tests running can also be done by using make:
> $cd src; sudo make test
Make targets test-37 and test-39 are available for testing specific Python versions.
IPS applications and libraries can be packaged and published into an IPS repository using:
> $cd src; make packages;
The above command generates IPS related packages and publishes them into packages/i386/repo on an x86-based system.
## Usage Examples
* Example 1 Create an Image With Publisher Configured
Create a new, full image, with publisher example.com, stored at /aux0/example_root.
> $ pkg image-create -F -p example.com=http://pkg.example.com:10000 \
> /aux0/example_root
* Example 2 Create an Image With No Publisher Configured
Create a new, full image with no publishers configured at /aux0/example_root.
> $ pkg image-create -F /aux0/example_root
* Example 3 Install a Package
Install the latest version of the widget package in the current image.
> $ pkg install application/widget
* Example 4 Add a Publisher
Add a new publisher example.com, with a repository located at http://www.example.com/repo.
> $ pkg set-publisher -g http://www.example.com/repo example.com
* Example 5 Add and Automatically Configure a Publisher
Add a new publisher with a repository located at /export/repo using automatic configuration.
> $ pkg set-publisher -p /export/repo
For more examples, please refer to List of References below or man page pkg(1) on Solaris operating system.
## Help
See for official Oracle Solaris support.
Discussion forums are available at:
-
-
## Contributing
Instead of submitting a pull request, please
[follow our contribution guide](./CONTRIBUTING.md).
## Security
Please consult the [security guide](./SECURITY.md) for our
security vulnerability reporting and disclosure process.
## License
Copyright (c) 2010, 2023, Oracle and/or its affiliates.
The Image Packaging System is primarily distributed under the terms of the CDDL (Common Development and Distribution License), with a few portions covered by BSD-style or MIT-style licenses.
Refer to [LICENSE.txt](./LICENSE.txt) (the CDDL),
[LICENSE-CPIO](./LICENSE-CPIO) (applies to src/modules/cpiofile.py),
and [LICENSE-MINISAT](./LICENSE-MINISAT) (applies to src/modules/solver/*)
for details.
## Documentation
1. [Packaging and Delivering Software With the Image Packaging System in Oracle® Solaris 11.4](https://docs.oracle.com/cd/E37838_01/html/E61051/index.html)
2. [Introducing the Basics of Image Packaging System (IPS) on Oracle Solaris 11](https://www.oracle.com/technical-resources/articles/it-infrastructure/o11-083-ips-basics.html)
3. [Oracle Solaris 11 Cheatsheet for Image Packaging System](https://www.oracle.com/technetwork/server-storage/solaris11/documentation/ips-one-liners-032011-337775.pdf)
4. [IPS Developer Documentation](./doc)