Difference between revisions of "Pacman troubleshooting"

no edit summary
imported>Verityproductions
imported>Verityproductions
Line 54: Line 54:




=== Editing the Mirrorlist ===
=== Opening the Mirrorlist ===


You will need to first open your terminal in order to (re)edit the mirrorlist file and correct the problem. The syntax of the command to edit the mirrorlist is:
You will need to first open your terminal in order to (re)edit the mirrorlist file and correct the problem. The syntax of the command to edit the mirrorlist is:
Line 71: Line 71:




=== Identifying and Fixing the Problem ===
=== Understanding the Mirrorlist ===


Once opened, the mirrorlist file presented should look similar to this (text has been coloured for illustrative purposes):
Once opened, the mirrorlist file presented should look similar to this (text has been coloured for illustrative purposes):
Line 99: Line 99:
'''Lines beginning with a hash '#' will be ignored by pacman.''' As such, the top part of the file is a table that lists the names of countries followed by their server internet addresses purely for your own information. Its purpose is to tell you - not pacman - which servers are available in what countries. The text coloured in <font color="red">red</font color> at the end of each internet address is there to tell you the <font color="red">download speed</font color> of the server. It is actually the bottom part of the file where the hashes have been removed that is intended to be used by pacman to connect to the manjaro servers. Notice that each of these lines begins with the command <font color="green">Server =</font color>.
'''Lines beginning with a hash '#' will be ignored by pacman.''' As such, the top part of the file is a table that lists the names of countries followed by their server internet addresses purely for your own information. Its purpose is to tell you - not pacman - which servers are available in what countries. The text coloured in <font color="red">red</font color> at the end of each internet address is there to tell you the <font color="red">download speed</font color> of the server. It is actually the bottom part of the file where the hashes have been removed that is intended to be used by pacman to connect to the manjaro servers. Notice that each of these lines begins with the command <font color="green">Server =</font color>.


As such, the most common reason for not being able to connect to the Manjaro servers will be due to removing hashes from the server addresses contained table at the top of the mirrorlist, without removing the text that tells you the <font color="red">download speed</font> of the server (e.g. '<font color="red">... 0.769</font color>'), and/or not starting the line with <font color="green">Server =</font color>


Where a server address has been unhashed in the table, you must therefore ensure that the server download speed listed at the end of the line is removed - including the dots ('...') -, otherwise pacman will think that this is part of the actual internet address. In addition, you must also ensure that the line begins with 'Server =', otherwise pacman will not know what the address is for. '''A much simpler solution is to replace any hashes removed from the beginning of any lines in the table, and use the servers listed for you at the bottom.''' The fastest servers will have been automatically chosen, anyway.
=== Fixing the Mirrorlist ===


Otherwise, if you had previously copied and pasted one or more addresses and/or typed them out manually, check to ensure that they are listed fully and correctly. A single missing or wrong character will be entirely enough to prevent pacman from connecting. Once your amendments have been completed save your changes and close the mirrorlist by:
The most common reasons for not being able to connect to the Manjaro servers are therefore due to:
 
* Not removing the text that tells you the <font color="red">download speed</font> of the server (e.g. '<font color="red">... 0.769</font color>'), and/or
* Not starting the server address line with the <font color="green">Server =</font color> command.
 
Ensure that the server download speed listed at the end of any server address line is removed - including the dots ('...') -, otherwise pacman will think that it is part of the actual internet address. In addition, ensure that any unhashed server address used begins with 'Server =', otherwise pacman will not know what the address is for. In addition, if you had previously copied and pasted one or more server addresses, or had manually typed them in, also ensure that what's listed is both complete and correct. A single missing or incorrect character will be enough to cause an error.
 
{{tip|If you had tried to use any of the server addresses contained in the table at the top of the mirrorlist by unhashing them, a much simpler solution is just to replace the hashes and use the servers listed for you at the bottom. The fastest servers will have been automatically chosen, anyway.}}
 
 
Once your amendments have been completed save your changes and close the mirrorlist by:


*'''nano''': Press CTRL and 'x' to exit, 'y' to save, and <enter> to finish, or
*'''nano''': Press CTRL and 'x' to exit, 'y' to save, and <enter> to finish, or
*'''gedit''': Select the 'save' option and then close the window.
*'''gedit''': Select the 'save' option and then close the window.