TritonDataCenter / TritonDataCenter/pkgsrc.smartos.org

Could use a page describing upgrade instructions

Open
#2 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
CSS
Stars
2
Forks
7
PR merge metrics
No merged PRs in 30d

Description

From an IRC conversation, @jperkin outlined it as:

"we set varbase to /var so the only thing you usually need to back up is any configs you've modified under /opt/local/etc

so save those out, wipe out /opt/local (and /var/db/pkgin for good measure), unpack new bootstrap, pkgin , restore /opt/local/etc/foo.conf and off you go

config files are normally handled by the original going into share/examples and then copied into etc, so it's not too difficult to script up a diff to show you what you

copies are only done if there is no existing conf, so an alternative is to simply restore the configs before pkgin and then they won't get overwritten

but then you need to handle applications which change config format etc"

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Use the quoted IRC upgrade procedure as the source material for a new documentation page. Cover backing up modified files under /opt/local/etc, removing the old installation, unpacking the new bootstrap, reinstalling packages with pkgin, and restoring configuration; done means the upgrade steps are clearly documented.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.