Opened 7 years ago

Closed 7 years ago

#2450 closed task (fixed)

Document that we sometimes need ldconfig after install

Reported by: shane Owned by: muks
Priority: medium Milestone: Sprint-20121204
Component: documentation Version:
Keywords: Cc:
CVSS Scoring: Parent Tickets:
Sensitive: no Defect Severity: High
Sub-Project: Core Feature Depending on Ticket: alpha2
Estimated Difficulty: 3 Add Hours to Ticket: 0
Total Hours: 0 Internal?: no

Description

On some systems, sometimes, we need to run ldconfig after install.

We should take the error that we get when this is not done, and put it in the documentation along with an explanation of what to do in this case. (We include the actual error message so that search engines can find it.)

Subtickets

Change History (11)

comment:1 Changed 7 years ago by shane

  • Feature Depending on Ticket set to alpha2

comment:2 Changed 7 years ago by jelte

  • Defect Severity changed from N/A to High
  • Milestone changed from Next-Sprint-Proposed to Sprint-20121120

comment:3 Changed 7 years ago by jelte

  • Estimated Difficulty changed from undecided to 3

comment:4 Changed 7 years ago by muks

  • Owner set to muks
  • Status changed from new to assigned

Picking

comment:5 Changed 7 years ago by muks

  • Owner changed from muks to UnAssigned
  • Status changed from assigned to reviewing

Up for review.

comment:6 Changed 7 years ago by jelte

  • Owner changed from UnAssigned to jreed

i have no comments, but jeremy might want to take a look at this, so i'm forwarding this to him :)

comment:7 follow-up: Changed 7 years ago by jreed

  • Owner changed from jreed to muks

I looked at d9c0f5f2d9294d8eb026bf92fd8fda103e9fc7

It should not be in the quick start guide too. If we try to document every issue in the quick start section it will no longer be a "quick start" :)

Also ldconfig is not used on some platforms.

Also about the "/usr/local" maybe also say "( or under the path used with --prefix)". It should not be just /usr/local/ but probably /usr/local/lib.

In addition, /etc/ld.so.conf may not be the correct file. Some systems use different filenames for the linker cache configuration.

With a few minor changes I think it will be okay.

comment:8 in reply to: ↑ 7 Changed 7 years ago by muks

  • Owner changed from muks to jreed

Hi Jeremy

Replying to jreed:

It should not be in the quick start guide too. If we try to document every issue in the quick start section it will no longer be a "quick start" :)

Removed from quick start guide. :)

Also ldconfig is not used on some platforms.

The instruction says "if required".

Also about the "/usr/local" maybe also say "( or under the path used with --prefix)". It should not be just /usr/local/ but probably /usr/local/lib.

Updated.

In addition, /etc/ld.so.conf may not be the correct file. Some systems use different filenames for the linker cache configuration.

Updated. :)

comment:9 Changed 7 years ago by jreed

  • Owner changed from jreed to muks

Thanks. Please merge to master.

comment:10 Changed 7 years ago by jreed

I don't think needs a changelog entry.

comment:11 Changed 7 years ago by muks

  • Resolution set to fixed
  • Status changed from reviewing to closed

Merged to master branch in commit 5bb4db417ecd1b94170fa87d11d91d604616c1bb:

* 0854840 [2450] Minor wrapping update
* c819412 [2450] Update to include any other linker cache config file
* 1c36cb6 [2450] Update library path taking prefix into account
* eb79abb [2450] Remove ldconfig instruction from quickstart section
* d9c0f5f [2450] Document in the guide that ldconfig has to be run sometimes

Resolving as fixed. Thank you for the reviews Jeremy.

Note: See TracTickets for help on using tickets.