<?xml version='1.0' encoding='UTF-8'?>
<!-- This document was created with Syntext Serna Free. -->
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent">
%BOOK_ENTITIES;
]>
<section id="sect-User_Guide-Account">
  <title>Account</title>
  <section id="sect-User_Guide-Account-Register_an_account">
    <title>Register an account</title>
    <para>
   To register a new account on the portal, do as follows:
  </para>
    <procedure>
      <title/>
      <step>
        <para>
     Go to the portal by inputting the URL in the address bar (e.g: <ulink url="http://localhost:8080/portal/public/classic" type="http"/>).
    </para>
        <para>
     The anonymous homepage will appear:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/homepage.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/homepage.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Click the <emphasis role="bold">Register</emphasis> link on the top of the site, the Register form will be displayed:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/register.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/register.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
        <para>
     (*) required
    </para>
        <para>
     The <emphasis role="bold">Account Setting</emphasis> information includes:
    </para>
        <table>
          <title/>
          <tgroup cols="2">
            <thead>
              <row>
                <entry> Field </entry>
                <entry> Information </entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry> User Name </entry>
                <entry> The user name that is used to log into the system. It must be unique. The user name must be started with a character. </entry>
              </row>
              <row>
                <entry> Password </entry>
                <entry> The security characters are used to log in. It must have at least 6 characters. </entry>
              </row>
              <row>
                <entry> Confirm Password </entry>
                <entry> The re-typed password above. The password in the <guilabel>Password</guilabel> field and this field must be the same. </entry>
              </row>
              <row>
                <entry> First Name </entry>
                <entry> Your first name. </entry>
              </row>
              <row>
                <entry> Last Name </entry>
                <entry> Your last name. </entry>
              </row>
              <row>
                <entry> Email Address </entry>
                <entry> Your email address. It must have a right format: <replaceable>username@abc.com</replaceable>.</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </step>
      <step>
        <para>
     Input values for the fields in this form.
    </para>
      </step>
      <step>
        <para>
     Click the 
     <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/magnifyingglassicon.png" format="PNG" width="7mm"/>
            </imageobject>
            <textobject>
               <phrase>magnifying glass</phrase>
            </textobject>
          </inlinemediaobject>
      icon to search and check if the inputted user name is available or not.
    </para>
      </step>
      <step>
        <para>
     Input values in the fields of<emphasis role="bold"> User Profile </emphasis>tab, including: Profile information, Home information and Business information.
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/userprofile.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/userprofile.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Save </emphasis>to register a new account, or <emphasis role="bold">Reset</emphasis> to renew all inputted values. There is an alert message, and you cannot add a new account successfully if at least one of these cases occurs:
    </para>
        <itemizedlist>
          <listitem>
            <para>
       The <guilabel>Username</guilabel> is existing or invalid.
      </para>
          </listitem>
          <listitem>
            <para>
      The <guilabel>Password</guilabel> has less than 6 characters.
      </para>
          </listitem>
          <listitem>
            <para>
       The <guilabel>Password</guilabel> and <guilabel>Confirm Password</guilabel> are not the same.
      </para>
          </listitem>
          <listitem>
            <para>
      The <guilabel>Email Address</guilabel> is in a invalid format.
      </para>
          </listitem>
          <listitem>
            <para>
      Any of the required fields are empty.
      </para>
          </listitem>
        </itemizedlist>
      </step>
    </procedure>
    <para>
   After adding a new account, contact the administrator to get the confirmation.
  </para>
    <note>
      <title>Email </title>
      <para>
    You should enter your email address exactly because when you forget username or password, you can recover it by using this email address.
   </para>
    </note>
  </section>
  <section id="sect-User_Guide-Account-Sign_In">
    <title>Sign In</title>
    <para>
   This function enables you to go into &PRODUCT; in the private mode.
  </para>
    <procedure id="proc-User_Guide-Sign_In-Sign_in">
      <title>Sign in</title>
      <step>
        <para>
     Go to your portal's home page by entering the URL in the address bar (e.g. <ulink url="http://localhost:8080//portal/public/classic/" type="http"/>).
    </para>
      </step>
      <step>
        <para>
     Click the <emphasis role="bold">Login</emphasis> link at the top of the home page. The <emphasis role="bold">Sign in</emphasis> form will appear:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/signin.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/signin.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Input your registered Username and Password.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Sign in </emphasis>to accept, or <emphasis role="bold">Discard</emphasis> to exit from the <emphasis role="bold">Sign in</emphasis> form.
    </para>
        <table id="tabl-User_Guide-Sign_in-Options">
          <title>Options</title>
          <tgroup cols="2">
            <thead>
              <row>
                <entry> Option </entry>
                <entry> Information </entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry> Username </entry>
                <entry> To input the registered username. </entry>
              </row>
              <row>
                <entry> Password </entry>
                <entry> To input the password of your username. </entry>
              </row>
              <row>
                <entry> Forgot your Username/Password </entry>
                <entry> To retrieve the forgotten username or password. </entry>
              </row>
              <row>
                <entry> Sign in </entry>
                <entry> To sign into the eXo Portal with the inputted user name and password. </entry>
              </row>
              <row>
                <entry> Discard </entry>
                <entry> To close the Sign In form without any changes. </entry>
              </row>
            </tbody>
          </tgroup>
        </table>
        <para>
     If the Username does not exist or the input Username/Password is invalid, there will be an alert message that requires you to input right values. The page will be redirected to the private security checking mode.
    </para>
        <para>
     To login again, enter Username and Password again.
    </para>
      </step>
    </procedure>
    <para>
   After signing in, you will be presented with the authenticated homepage:
  </para>
   <mediaobject>
      <imageobject role="html">
        <imagedata  align="center"  fileref="images/authhomepage.png" format="PNG"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata   align="center" fileref="images/authhomepage.png" format="PNG" width="150mm"/>
      </imageobject>
    </mediaobject>
      <note>
          <title>Toolbar Visibility</title>
          <para>
              The toolbar in the image above is, by default, only visible to members of the
              <emphasis>/platform/web-contributors</emphasis>
              role.
          </para>
          <para>
              See
              <xref linkend="sect-User_Guide-Account-Toolbar_Visibility"/>
              for information about how to add the required permissions and/or change the default portal behavior.
          </para>
      </note>
  </section>
  <section id="sect-User_Guide-Account-Sign_Out">
    <title>Sign Out</title>
    <para>
   The function lets you get back to the anonymous portal. It ends your current portal session.
  </para>
    <para>
   To sign out, click the <emphasis role="bold">Logout</emphasis> link on the right access banner:
  </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata align="center"  fileref="images/accessbanner.png" format="PNG"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata  align="center" fileref="images/accessbanner.png" format="PNG" width="82mm"/>
      </imageobject>
    </mediaobject>
    <para>
   Alternatively, members of the <emphasis>/platform/web-contributors</emphasis> role can click <menuchoice>
      <guimenu>Start Logo</guimenu>
      <guimenuitem>Sign Out</guimenuitem>
   </menuchoice> from the toolbar:
  </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata  align="center"  fileref="images/startlogo.png" format="PNG"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata   align="center" fileref="images/startlogo.png" format="PNG" width="150mm"/>
      </imageobject>
    </mediaobject>
  </section>
  <section id="sect-User_Guide-Account-Retrieve_user_namepassword">
    <title>Retrieve Username/Password</title>
    <para>
   If you forget your account or password, you can recover them by doing as follows:
  </para>
    <procedure>
      <title/>
      <step>
        <para>
     Click the link <emphasis role="bold">Forgot your Username/Password?</emphasis> in the <guilabel>Sign in</guilabel> form.
    </para>
        <para>
     This form offers two options:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/retrieve.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/retrieve.png" format="PNG" width="147mm"/>
          </imageobject>
        </mediaobject>
        <variablelist>
          <varlistentry>
            <term>Forgot My Password:</term>
            <listitem>
              <para>
        If you forgot your password, you need to select this option.
       </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Forgot My Username:</term>
            <listitem>
              <para>
        If you forgot your username, you need to select this option.
       </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </step>
      <step>
        <para>
     Select one of these two options in this form. The selected option will be shown:
    </para>
        <para>
     If the <emphasis role="bold">Forgot My Password</emphasis> option is selected, the form to recover the password appears:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/forgotpassword.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/forgotpassword.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
        <para>
     If the <emphasis role="bold">Forgot My Username</emphasis> option is selected, the form to recover the username appears:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/forgotname.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/forgotname.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Enter your username or email in the corresponding form.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Send</emphasis> to send the input values.
    </para>
        <para>
     Once the information has been sent, you will receive an email with your Username/Password in your email address that you registered.
    </para>
        <itemizedlist>
          <listitem>
            <para>
       If you forget Username: when a username is retrieved, your old username is restored and can be reused and a new password is also sent to your email with the old username.
      </para>
          </listitem>
          <listitem>
            <para>
       If you forget old password: a new password will be set (as temporary, then you will be directed to change the password for the next time you sign in).
      </para>
          </listitem>
        </itemizedlist>
      </step>
    </procedure>
  </section>
  <section id="sect-User_Guide-Account-Change_Account_Information">
    <title>Change account information</title>
    <para>
   The function enables you change your account information, such as your profile and password.
  </para>
    <procedure>
      <title/>
      <step>
        <para>
     The first thing to do is to directly click your own account name.
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/accountname.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/accountname.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
        <para>
     The <emphasis role="bold">Account Profiles</emphasis> tab will appear:
    </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/accountprofile.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/accountprofile.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
    </procedure>
    <procedure id="proc-User_Guide-Change_Account_Information-To_Change_Account_Profiles">
      <title>To Change Account Profiles</title>
      <step>
        <para>
     Select the<emphasis role="bold"> Account Profiles</emphasis> tab.
    </para>
        <para>
     This tab displays your current basic information.
    </para>
      </step>
      <step>
        <para>
     Change your First Name, Last Name and Email. You cannot change your Username.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Save</emphasis> to accept changes.
    </para>
      </step>
    </procedure>
    <procedure id="proc-User_Guide-Change_Account_Information-To_change_your_Password">
      <title>To change your Password</title>
      <step>
        <para>
     Select the<emphasis role="bold"> Change Password</emphasis> tab.
    </para>
       <mediaobject>
          <imageobject role="html">
            <imagedata  align="center"  fileref="images/changepassword.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata   align="center" fileref="images/changepassword.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Input your current password to identify that you are the owner of this account.
    </para>
      </step>
      <step>
        <para>
     Input your new password, it must have at least 6 characters.
    </para>
      </step>
      <step>
        <para>
     Input your password again in the <emphasis role="bold">Confirm New Password</emphasis> field.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Save</emphasis> to accept changes.
    </para>
      </step>
    </procedure>
  </section>
    <section id="sect-User_Guide-Account-Toolbar_Visibility">
        <title>Toolbar Visibility</title>
        <!-- Source Metadata
        URL: https://access.redhat.com/kb/docs/DOC-54051
        Author: Red Hat GSS
        License: -->
        <para>
            Newly registered users (or other users who are not members of the
            <emphasis>/platform/web-contributors</emphasis>
            role) will not see the toolbar at the top of the home page. These users will, however, be able to sign into
            and out of the Portal using the appropriate buttons in the site header.
        </para>
        <para>
            Portal administrators can add individual users to the
            <emphasis>/platform/web-contributors</emphasis>
            through the graphical user interface (GUI):
        </para>
        <procedure>
            <title>Add Permission via GUI</title>
            <step>
                <para>
                    Click
                    <menuchoice>
                        <guimenu>Group</guimenu>
                        <guimenuitem>Organization</guimenuitem>
                        <guimenuitem>Users and groups management</guimenuitem>
                    </menuchoice>
                    , then click <guilabel>Group Management</guilabel>.
                </para>
            </step>
            <step>
                <para>
                    Click
                    <menuchoice>
                        <guimenu>Platform</guimenu>
                        <guimenuitem>Content Manager</guimenuitem>
                    </menuchoice>
                    in the left pane.
                </para>
            </step>
            <step>
                <para>
                    Enter the required username in the
                    <guilabel>Add member</guilabel>
                    box (the above lists all users already in that role).
                </para>
            </step>
        </procedure>
        <warning>
            <title>CMS Access</title>
            <para>
                Be aware that granting this membership will also give the user access to the Content Management System
                (CMS).
            </para>
        </warning>
    </section>
</section>