Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 114337

Summary: Recommended minimum partition size for /var is insufficient
Product: [OLD] Docs-user Reporter: Erik <esigra>
Component: HandbookAssignee: Łukasz Damentko (RETIRED) <rane>
Status: VERIFIED FIXED    
Severity: normal CC: docs-team, nightmorph, radek
Priority: High    
Version: unspecified   
Hardware: x86   
OS: Linux   
URL: http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?full=1
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: changed partition size
x86 handbook fix
x86 2005.1 handbook fix
amd64 2005.1 handbook fix
amd64 handbook fix
amd64, x86, sparc handbook fixes
amd64, sparc, x86 handbook changes
the RIGHT amd64,sparc,x86 handbook fix. non-2005.1.
2005.1 sparc, x86, amd64 handbook fixes
2005.1 sparc. amd64, x86 handbook patches
sparc, amd64, x86 handbook fix. non-2005.1

Description Erik 2005-12-03 03:26:16 UTC
From the documentation at  
[http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?full=1]:  
  
"you should have /var with at least 1G free if you don't want to compile big  
programs and at least 3G free if compiling KDE or OpenOffice.org"  
  
I tried to emerge Openoffice and it used 3.5G. Then it failed because the  
partition was full. So the recommended minimum partition size for /var in the 
handbook is obviously too small. 

Reproducible: Always
Steps to Reproduce:
1. Install Gentoo and make a partition with 4000000 1k-blocks (3.9G) for /var. 
2. emerge openoffice 
Actual Results:  
No space left on device
Comment 1 Anders Hellgren gentoo-dev 2005-12-03 04:41:45 UTC
According to Bug 88588 you may need 8GB or even more for OOo-2.
Comment 2 nm (RETIRED) gentoo-dev 2005-12-19 06:48:42 UTC
Created attachment 75095 [details, diff]
changed partition size

As requested, changed the recommended /var partition size to 8G, after examining the above bug and browsing the forums for some given compile values.

Better to be safe than sorry, right? :)
Comment 3 nm (RETIRED) gentoo-dev 2005-12-19 14:35:19 UTC
Created attachment 75141 [details, diff]
x86 handbook fix

Revised fix. Kept 8G and added version/date bumps. Will do for all other arches that have this in their handbooks. :)
Comment 4 nm (RETIRED) gentoo-dev 2005-12-19 14:41:21 UTC
Created attachment 75142 [details, diff]
x86 2005.1 handbook fix

2005.1 x86 handbook.
Comment 5 nm (RETIRED) gentoo-dev 2005-12-19 14:44:28 UTC
Created attachment 75143 [details, diff]
amd64 2005.1 handbook fix

2005.1 amd64 handbook fix
Comment 6 nm (RETIRED) gentoo-dev 2005-12-19 14:46:23 UTC
Created attachment 75145 [details, diff]
amd64 handbook fix

amd64 handbook fix
Comment 7 SpanKY gentoo-dev 2005-12-19 15:07:08 UTC
no, the text should read:
+least 1G free if you don't want to compile big programs and at least 8G free if
Comment 8 nm (RETIRED) gentoo-dev 2005-12-19 15:26:44 UTC
Created attachment 75152 [details, diff]
amd64, x86, sparc handbook fixes

This replaces the NON-2005.1 handbook patches. As per jkt's request, rolled all three changes into one patch. the three 2005.1 handbook changes will follow shortly in their own patch.
Comment 9 SpanKY gentoo-dev 2005-12-19 15:33:11 UTC
Comment on attachment 75152 [details, diff]
amd64, x86, sparc handbook fixes

"large programs" isnt really helpful ... giving the examples of KDE and OOo.org served their purpose

best to be written:
... if you will be compiling large programs (such as OpenOffice.org or KDE)
Comment 10 nm (RETIRED) gentoo-dev 2005-12-19 15:33:56 UTC
Created attachment 75153 [details, diff]
amd64, sparc, x86 handbook changes

For the non-2005.1 handbooks. Revised wording slightly as per jkt's request. That's all. :)
Comment 11 Łukasz Damentko (RETIRED) gentoo-dev 2005-12-19 15:43:06 UTC
Even users who want to compile openoffice on their own, don't need to have 10GB big /var.
I'll add information about compiling big programs (like KDE/OO) to faq.xml (with WORKDIR changes, nptl mention, LINGUAS setting and so on), and then make a reference to it from all the handbook disk chapters.
Comment 12 nm (RETIRED) gentoo-dev 2005-12-19 15:49:49 UTC
Created attachment 75155 [details, diff]
the RIGHT amd64,sparc,x86 handbook fix. non-2005.1.

Oops. the previous patch was wrong. This one is correct. Really. :)
Comment 13 nm (RETIRED) gentoo-dev 2005-12-19 16:00:04 UTC
Created attachment 75159 [details, diff]
2005.1 sparc, x86, amd64 handbook fixes

This is the 2005.1 handbook fix for the sparc, x86, and amd64 arches. Enjoy.
Comment 14 Xavier Neys (RETIRED) gentoo-dev 2005-12-20 06:41:38 UTC
I don't think recommending 8GB to compile large programs is very wise.
Most users would consider gnome,kde,mozilla and many more large programs.

ebuild /usr/portage/app-office/openoffice/openoffice-2.0.0.ebuild install
is running to assess the real requirements for OOo2
Comment 15 Xavier Neys (RETIRED) gentoo-dev 2005-12-21 01:57:46 UTC
(In reply to comment #14)
> ebuild /usr/portage/app-office/openoffice/openoffice-2.0.0.ebuild install
> is running to assess the real requirements for OOo2

Done.
We're far from the claimed 8GB
I had wiped /var/tmp/{ccache,portage} before starting

basil ~ # du -hs /var/*
103M    /var/cache
204M    /var/db
54M     /var/lib
58M     /var/log
0       /var/mail
49K     /var/run
52K     /var/spool
0       /var/state
4.1G    /var/tmp
946K    /var/www

basil ~ # du -hs /var/tmp/*
341M    /var/tmp/ccache
3.8G    /var/tmp/portage
0       /var/tmp/portage-pkg
4.0K    /var/tmp/sync
Comment 16 nm (RETIRED) gentoo-dev 2005-12-22 11:13:10 UTC
Created attachment 75338 [details, diff]
2005.1 sparc. amd64, x86 handbook patches

Revised GB amount down to 5 (from 8). Much more reasonable. For 2005.1 handbooks.
Comment 17 nm (RETIRED) gentoo-dev 2005-12-22 11:14:39 UTC
Created attachment 75339 [details, diff]
sparc, amd64, x86 handbook fix. non-2005.1

Revised GB down to 5 (from 8). Much more reasonable. For non-2005.1 handbook.
Comment 18 nm (RETIRED) gentoo-dev 2005-12-22 13:41:43 UTC
(In reply to comment #17)
> Created an attachment (id=75339) [edit]
> sparc, amd64, x86 handbook fix. non-2005.1
> 
> Revised GB down to 5 (from 8). Much more reasonable. For non-2005.1 handbook.
Personally, I think 5GB is just fine. 8 sounds like it would drive users away, as they might think that they don't have enough disk space to properly install gentoo. However, given that it does take up at least ~4GB (as per neysx's results) or 8GB (as per the above link by the original reporter), it's smart to increase the minimum to 5GB. I talked to the Portage guys, and it turns out that /tmp is not used in compiling unless the user sets a variable, so all the work space is done in /var, which means it had better have plenty of space available.

I also think that maybe the references to OpenOffice, KDE, and Mozilla should be taken out of the documents at that point. We should leave it up to the user to decide what he wants to install, and how much space is available. So, as per the earlier patch, a generic "big packages" reference to needed space could be used.

On the other hand, users might want to know what's considered a "big package", in which case mentioning KDE && OpenOffice might be beneficial.

It's your call; I can make changes for any of the above. Just let me know. I'm very pragmatic. :)
Comment 19 Jan Kundrát (RETIRED) gentoo-dev 2005-12-24 09:56:31 UTC
> On the other hand, users might want to know what's considered a "big package",
> in which case mentioning KDE && OpenOffice might be beneficial.

Neither KDE nor Mozilla are big packages when speaking about disk usage, at least AFAIK.
Comment 20 Łukasz Damentko (RETIRED) gentoo-dev 2005-12-31 23:41:36 UTC
Proposed fix:

Change:
"For /var, people might think the assigned space is too much. However, Gentoo compiles all programs inside /var/tmp/portage, so you should have /var with at least 1G free if you don't want to compile big programs and at least 3G free if compiling KDE or OpenOffice.org is no big deal for you."

With:
"If you think that few gigabytes for /var is way too much, please remember that it's used by Portage to compile all the packages. However, you can make it much smaller (around 1GB) and, before building very big packages (like OpenOffice.org), alter your PORTAGE_TMPDIR variable to a directory which has enough space to build them."

Any comments on that?
Comment 21 nm (RETIRED) gentoo-dev 2006-01-01 10:27:56 UTC
(In reply to comment #20)
Based on rane's suggestion, how about this:

Although allocating a few gigabytes of disk space for <path>/var</path> may seem excessive, remember that Portage uses this partition by default for compiling packages. If you want to keep <path/var</path> at a more reasonable size, such as 1GB, you will need to alter your PORTAGE_TMPDIR variable in <path>/etc/make.conf</path> to point to the partition with enough free space for compiling extremely large packages such as OpenOffice.
Comment 22 Łukasz Damentko (RETIRED) gentoo-dev 2006-01-01 10:38:10 UTC
In CVS, big thanks for reporting and all the comments here.