https://wiki.archlinux.org/api.php?action=feedcontributions&user=Undersc0re97&feedformat=atomArchWiki - User contributions [en]2024-03-28T16:58:56ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Netctl&diff=253609Netctl2013-04-10T14:19:14Z<p>Undersc0re97: </p>
<hr />
<div>{{Lowercase title}}<br />
[[Category:Networking]]<br />
[[es:Netcfg]]<br />
[[fr:Netcfg]]<br />
[[it:Netcfg]]<br />
[[ja:Netcfg]]<br />
[[ro:Netcfg]]<br />
[[ru:Netcfg]]<br />
[[tr:netcfg]]<br />
[[zh-CN:Netcfg]]<br />
{{Article summary start}}<br />
{{Article summary text|A guide to configuring the network using netctl and network profile scripts.}}<br />
{{Article summary end}}<br />
Netctl is a new Arch project slated to replace [[netcfg]]. Users should regard it as the future of CLI-based network management on Arch Linux.<br />
<br />
==Installation==<br />
The {{Pkg|netctl}} package is available in [[Official Repositories#&#91;core&#93;|&#91;core&#93;]]. Installing netctl will replace netcfg. As of netctl version 0.7, optional dependencies include<br />
*{{Pkg|dialog}}, for menu based WiFi assistance ({{Pkg|wifi-menu}})<br />
*{{Pkg|dhclient}}, for DHCP support<br />
*{{Pkg|dhcpcd}}, for DHCP support (instead of dhclient)<br />
*{{Pkg|wpa_supplicant}}, for wireless network support<br />
*{{Pkg|ifplugd}}, for automatic wired connections through {{ic|netctl-ifplugd}}<br />
*{{Pkg|ifenslaved}}, for bond connections<br />
*{{Pkg|bridge-utils}}, for bridge connections<br />
*{{Pkg|ppp}}, for pppoe connection<br />
<br />
==Recommended Reading==<br />
Considerable effort has gone into the construction of quality man pages. Users are encouraged to read the following man pages prior to using netctl:<br />
*netctl<br />
*netctl.profile<br />
*netctl.special<br />
<br />
==Configuration==<br />
<br />
{{ic|netctl}} may be used to introspect and control the state of the systemd services for the network profile manager. Example configuration files are provided for the user to assist them in configuring their network connection. These example profiles are located in {{ic|/etc/netctl/examples/}}. The common configurations include:<br />
*ethernet-dhcp<br />
*ethernet-static<br />
*wireless-wpa<br />
*wireless-wpa-static<br />
<br />
To use an example profile, simply copy one of them from {{ic|/etc/netctl/examples/<profile>}} to {{ic|/etc/netctl/<profile>}} and configure it to your needs:<br />
# cp /etc/netctl/examples/wireless-wpa /etc/netctl/my-wireless-wpa<br />
<br />
Once you have created your profile, make an attempt to establish a connection using the newly created profile by running:<br />
# netctl start <profile><br />
<br />
If issuing the above command results in a failure, then use {{ic|journalctl -xn}} and {{ic|netctl status <profile>}} in order to obtain a more in depth explanation of the failure. Make the needed corrections to the failed configuration and retest.<br />
<br />
Once the profile is started successfully then it can be {{ic|enabled}} using {{ic|netctl enable <profile>}}. This will create the proper symlink for the profile to be used by {{ic|netctl-auto@.service}}.<br />
<br />
{{Note| the systemd service {{ic|netctl-auto@<interface>.service}} will need to be enabled in order to allow automatic wireless connection at boot to become functional.}}<br />
<br />
{{Note| If there is ever a need to alter a currently enabled profile. {{ic|netctl reenable <profile>}} will have to executed in order to apply the changes.}}<br />
<br />
===Migrating from netcfg===<br />
<br />
{{ic|netctl}} uses {{ic|/etc/netctl}} to store its profiles, ''not'' {{ic|/etc/network.d}} ({{ic|netcfg}}'s profile storage location).<br />
<br />
In order to migrate from netcfg, at least the following is needed:<br />
*Move network profile files to the new directory.<br />
*Rename variables therein according to netctl.profile(5) (most have only become CamelCase i.e CONNECTION= becomes Connection=).<br />
*Unquote interface variables and other variables that don't strictly need quoting (this is mainly a style thing).<br />
*Run {{ic|netctl enable <profile>}} for every profile in the old NETWORKS array. 'last' doesn't work this way, see netctl.special(7).<br />
*Use {{ic|netctl list}} / {{ic|netctl start <profile>}} instead of netcfg-menu. wifi-menu remains available.<br />
<br />
===Password Encryption (256-bit PSK)===<br />
<br />
Users ''not'' wishing to have their passwords stored in ''plain text'' have the option of generating a 256-bit Encrypted PSK.<br />
<br />
If you have not done so already, install {{pkg|wpa_actiond}} from the [[Official Repositories#&#91;core&#93;|&#91;core&#93;]] repository using [[pacman]]<br />
# pacman -S wpa_actiond<br />
<br />
Next, generate your 256-bit Encrypted PSK using [[WPA_supplicant#Configuration_file|wpa_passphrase]]:<br />
{{hc|Usage: wpa_passphrase [ssid] [passphrase]|<br />
2=$ wpa_passphrase archlinux freenode|<br />
network={<br />
ssid="archlinux"<br />
#psk="freenode"<br />
psk=64cf3ced850ecef39197bb7b7b301fc39437a6aa6c6a599d0534b16af578e04a<br />
}<br />
{{Note|This information will be used in your profile so do not close the terminal}}<br />
}}<br />
<br />
In a second terminal window copy the example file {{ic|wireless-wpa}} from {{ic|/etc/netctl/examples}} to {{ic|/etc/netctl}}.<br />
# cp /etc/netctl/examples/wireless-wpa /etc/netctl/wireless-wpa<br />
<br />
You will then need to edit {{ic|/etc/netctl/wireless-wpa}} using your favorite text editor and add the ''Encrypted Pre-shared Key'' that was generated early using wpa_passphrase to the {{ic|'''Key'''}} variable of this profile.<br />
<br />
Once completed your network profile {{ic|wireless-wpa}} containing a 256-bit Encrypted PSK should resemble:<br />
{{hc|/etc/netctl/wireless-wpa|2=<br />
Description='A simple WPA encrypted wireless connection using 256-bit Encrypted PSK'<br />
Interface=wlp2s2<br />
Connection=wireless<br />
Security=wpa<br />
IP=dhcp<br />
ESSID=archlinux<br />
Key=\"64cf3ced850ecef39197bb7b7b301fc39437a6aa6c6a599d0534b16af578e04a<br />
}}<br />
{{Note|1=Make sure to use the '''special non-quoted rules''' for Key= that are explained at the end of netctl.profile(5)}}<br />
<br />
==Support==<br />
Official announcement thread: https://bbs.archlinux.org/viewtopic.php?id=157670</div>Undersc0re97https://wiki.archlinux.org/index.php?title=MATE&diff=253003MATE2013-04-05T14:56:03Z<p>Undersc0re97: SigLevel = Optional TrustAll is now needed with new pacman release</p>
<hr />
<div>[[Category:Desktop environments]]<br />
[[es:MATE]]<br />
[[it:MATE]]<br />
[[ja:MATE]]<br />
[[ko:MATE]]<br />
[[ru:MATE]]<br />
[[zh-CN:MATE]]<br />
{{Article summary start}}<br />
{{Article summary text|What is MATE and how to get it.}}<br />
{{Article summary heading|Required software}}<br />
{{Article summary link|MATE|http://mate-desktop.org}}<br />
{{Article summary heading|Related}}<br />
{{Article summary wiki|GNOME}}<br />
{{Article summary end}}<br />
<br />
The '''MATE Desktop Environment''' is a fork of GNOME 2 that aims to provide an attractive and intuitive desktop to Linux users using traditional layouts and methods. For more information, see [https://bbs.archlinux.org/viewtopic.php?id=121162 this forum thread.]<br />
<br />
== Obtaining ==<br />
<br />
MATE is currently developed on [https://github.com/mate-desktop GitHub].<br />
Stable packages with release-based version numbering are hosted on http://repo.mate-desktop.org/archlinux/.<br />
<br />
== Installation ==<br />
<br />
To install the stable version of MATE via [[pacman]] add the following lines to your {{ic|/etc/pacman.conf}}:<br />
<br />
{{bc|<nowiki><br />
[mate]<br />
SigLevel = Optional TrustAll<br />
Server = http://repo.mate-desktop.org/archlinux/$arch<br />
</nowiki>}}<br />
<br />
Run<br />
<br />
# pacman -Syy<br />
<br />
and then<br />
<br />
# pacman -S mate<br />
<br />
It might also be of interest to people to install certain packages from the '''mate-extras''' group (most being counterparts to packages in the {{Grp|gnome-extra}} group):<br />
<br />
# pacman -S mate-extras<br />
<br />
== Starting ==<br />
<br />
=== Manually ===<br />
<br />
In order to start MATE manually, you must add<br />
<br />
exec mate-session<br />
<br />
to your {{ic|[[xinitrc|~/.xinitrc]]}} file and then run<br />
<br />
$ startx<br />
<br />
{{note|See [[xinitrc]] for details, such as preserving the logind (and/or consolekit) session.}}<br />
<br />
=== Automatically at boot time ===<br />
<br />
See [[Display Manager]] and [[Start X at Boot]] for details.<br />
<br />
==== GDM (Old) ====<br />
<br />
If you are using {{AUR|gdm-old}} from the AUR, simply select the MATE session from the Sessions list. For your first time launching MATE, make sure to click "Just this session" when prompted.<br />
<br />
==== [[LightDM]], [[GDM]] & [[LXDM]] ====<br />
<br />
Just select MATE from the Sessions list. Works well.<br />
<br />
==== MATE Display Manager ====<br />
<br />
The MATE Display Manager (MDM) is the MATE desktop's counterpart to the GNOME Display Manager (GDM). It's package 'mate-display-manager' has been found in the '''mate-extra''' group or in the AUR package {{AUR|mate-display-manager}}. It has worked relatively the same as GDM does/did; unfortunately, the subproject is currently in flux, and MDM is not now (2012/07/01) available.<br />
<br />
==== [[KDM]] ====<br />
<br />
In order to be able to launch MATE from [[KDM]], the [[KDE]] Display Manager, you have to edit the KDM configuration.<br />
As root, edit the <code>/usr/share/config/kdm/kdmrc</code> configuration file. Find the '''SessionsDir''' parameter and add <code>/usr/share/xsessions</code> to the list.<br />
It should then look like this:<br />
<br />
SessionsDirs=/usr/share/config/kdm/sessions,/usr/share/apps/kdm/sessions,/usr/share/xsessions<br />
<br />
Restart KDM and select the "MATE session" from the list.<br />
<br />
==== [[SLIM]] ====<br />
<br />
Just fоllow the [[SLIM]] tutorial to know how to install and how to copy and use the .xinitrc file. And just add this line to the .xinitrc file :<br />
exec mate-session<br />
<br />
== Applications ==<br />
<br />
It is important to note that many GNOME core applications are rebranded for MATE, as per the licensing terms. Here is a simple Rosetta Stone of GNOME -> MATE applications. <br />
<br />
* Nautilus is renamed '''Caja'''<br />
* Metacity is renamed '''Marco'''<br />
* Gconf is renamed '''Mate-conf''' <br />
* Gedit is renamed '''Pluma'''<br />
* Eye of GNOME is renamed '''Eye of MATE''' <br />
* Evince is renamed '''Atril''' <br />
* File Roller is renamed '''Engrampa''' <br />
* GNOME Terminal is renamed '''MATE Terminal''' <br />
<br />
Other applications and core components prefixed with GNOME (such as GNOME Panel, GNOME Menus etc) have simply had the prefix renamed "MATE" and become MATE Panel and MATE Menus.<br />
<br />
Not all of the GNOME extra applications (built for GTK2) have been forked yet. The following extra applications '''are''' available in MATE:<br />
<br />
* Totem (mate-video-player)<br />
* GNOME Panel applets (mate-applets)<br />
<br />
If you are using NetworkManager to connect to the internet, you can install {{AUR|network-manager-applet-gtk2}} from the AUR for a GTK2 nm-applet. You will need to modify the PKGBUILD to depend on mate-bluetooth rather than gnome-bluetooth to prevent a recursive dependency on gnome-desktop.<br />
<br />
== Known issues ==<br />
<br />
=== Qt Applications are not styled ===<br />
<br />
You may find that Qt4 applications are not inheriting the GTK2 theme like they should. This can be fixed easily by running qtconfig and setting GTK+ as GUI style under System ⇒ Preferences ⇒ QT4 Settings.<br />
<br />
=== Evolution Email Not Working ===<br />
<br />
Please see [[Evolution#Using_Evolution_Outside_Of_Gnome]].<br />
<br />
=== GTK3 Applications Not Properly Styled ===<br />
<br />
If you notice that applications such as [[Rhythmbox]] do not have styling applied to them, try [https://aur.archlinux.org/packages/clearlooks-phenix-gtk-theme-git/ Clearlooks Phenix] theme.<br />
<br />
== Troubleshooting ==<br />
<br />
=== User Switch ===<br />
<br />
If you are not using MDM (Mate Display Manager) user switch is disabled, to enable create the symbolic links.<br />
<br />
==== [[LightDM]] ====<br />
<br />
# ln -s /usr/lib/lightdm/lightdm/gdmflexiserver /usr/bin/mdmflexiserver<br />
<br />
==== [[GDM]] ====<br />
<br />
# ln -s /usr/bin/gdmflexiserver /usr/bin/mdmflexiserver</div>Undersc0re97