source: lxqt/desktop/pre-install.xml@ e49abaf8

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="lxqt-pre-install" xreflabel="LXQt Pre-Install">
  <?dbhtml filename="pre-install.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LXQt Desktop Pre-Install Instructions</title>

   <indexterm zone="lxqt-pre-install">
    <primary sortas="g-lxqt-pre-install">LXQt Pre-Install</primary>
   </indexterm>

    <caution><para>Due to recent changes in <command>grep</command> it is
    essential that the installing system be set to a UTF-8 locale.  An example
    is <command>export LANG=en_US.utf8</command>, but any UTF-8 locale is
    sufficient.  Failure to do this will result in a faulty
    installation.</para></caution>

    <para>
      LXQt can be installed in /usr or /opt/lxqt.
    </para>

  <sect2><title>Installing in /usr</title>

    <para>
      Installing in <filename class="directory">/usr</filename> creates
      a simpler setup.  Run:</para>

<screen><userinput>export LXQT_PREFIX=/usr</userinput></screen>

    <para>
      Either add that to your own <filename>.bash_profile</filename>
      so that it will still be set if you build the packages over a
      period of time, or else add it to the system profile as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>cat &gt; /etc/profile.d/lxqt.sh &lt;&lt; "EOF"
<literal># Begin LXQt profile

export LXQT_PREFIX=/usr

# End LXQt profile</literal>
EOF</userinput></screen>

    <para>
      The rest of this page is for people who wish to use the alternative
      prefix.
    </para>

  </sect2>

  <sect2>
    <title>Installing in /opt/lxqt</title>

    <para>
      Installing in <filename class="directory">/opt/lxqt</filename> may
      simplify upgrading to a later version of LXQt.
    </para>

    <para>
      Some variables need to be defined in your system profile, as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>install -vdm755 /opt/lxqt/{bin,lib,share/man}</userinput></screen>

<screen role="root"><userinput>cat &gt; /etc/profile.d/lxqt.sh &lt;&lt; "EOF"
<literal># Begin LXQt profile

export LXQT_PREFIX=/opt/lxqt

pathappend /opt/lxqt/bin           PATH
pathappend /opt/lxqt/share/man/    MANPATH
pathappend /opt/lxqt/lib/pkgconfig PKG_CONFIG_PATH

# End LXQt profile</literal>
EOF</userinput></screen>

    <para>
      Expand your <filename>/etc/ld.so.conf</filename> file:
    </para>

<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
<literal>
# Begin LXQt addition

/opt/lxqt/lib

# End LXQt addition
</literal>
EOF</userinput></screen>

  <para>
    Before starting to install the packages in the following pages, remember to
    execute:
  </para>

<screen><userinput>source /etc/profile</userinput></screen>

    <para>
      Some packages may also install icons from the "hicolor" icon set. Since
      that icon set is used by many packages, it is a good idea to create a
      symlink to the one in <filename class="directory">/usr/share</filename>
      to avoid having multiple installations of <xref
      linkend="hicolor-icon-theme"/>.  Run the following commands as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>source /etc/profile                                       &amp;&amp;
install -v -dm755                $LXQT_PREFIX/share/icons &amp;&amp;
ln -sfv /usr/share/icons/hicolor $LXQT_PREFIX/share/icons</userinput></screen>


    <tip>
      <para>
        Sometimes, the installation paths are hardcoded into installed files.
        This is the reason why <filename class="directory">/opt/lxqt</filename>
        is used as installation prefix instead of <filename
        class="directory">/opt/lxqt-&lxqt-version;</filename>. After installing
        <application>LXQt Desktop</application>, you may rename the directory
        and create a symlink:
      </para>

<screen role="root"><userinput>mv /opt/lxqt{,-&lxqt-version;}
ln -sfv lxqt-&lxqt-version; /opt/lxqt</userinput></screen>

      <para>
        Later on, you may want to install other versions of <application>LXQt
        Desktop</application>. To do that, just remove the symlink and use
        <filename class="directory">/opt/lxqt</filename> as the prefix again.
        Which version of <application>LXQt Desktop</application> you use
        depends only on where the symlink points. No other reconfiguration will
        be needed.
      </para>
    </tip>

  </sect2>

</sect1>