Skip to content

Commit

Permalink
Updated user-guide
Browse files Browse the repository at this point in the history
  • Loading branch information
@nkhare
nkhare committed Jan 13, 2011
1 parent a05d967 commit 93f54f6
Showing 1 changed file with 68 additions and 45 deletions.
113 changes: 68 additions & 45 deletions user-guide/user-guide.xml
View file
Expand Up @@ -26,28 +26,28 @@ operations and features.
</answer>
</qandaentry>
<qandaentry>
<question><para>zfs rollback panic</para>
<question><para><command>zfs rollback</command> panic</para>
</question>
<answer><para>Under certain conditions zfs rollback might panic
the system. Please backup your data before attempting this and we
recommend that you reboot the machine and run zpool scrub should
this occur.. </para>
recommend that you reboot the machine and run zpool scrub after the
rollback. </para>
</answer>
</qandaentry>
<qandaentry>
<question><para> Migrating data between solaris and linux</para>
<question><para> Migrating data between Solaris and Linux</para>
</question>
<answer><para>Although the pool layout in this port is exactly the
same as that on opensolaris there are subtle differences. Firstly
same as that on Opensolaris, there are subtle differences. Firstly
ACLs are not supported and fuids are never populated in
linux. Please contact us before you attempt to import a filesystem
from solaris to linux. Secondly the extended attributes in linux
Linux. Please contact us before you attempt to import a filesystem
from Solaris to Linux. Secondly the extended attributes in Linux
are implemented by prefixing the attribute name with the attribute
class. e.g. "user." for user attributes "security." for selinux
class. e.g. "user." for user attributes "security." for SELinux
security attributes. This imposes the restrition that any
arbitrary named attribute will not exist on linux, it will have a
arbitrary named attribute will not exist on Linux, it will have a
prefix either "user" or "security". While the attributes in
opensolaris can have any arbitrary name.
Opensolaris can have any arbitrary name.
</para>
</answer>
</qandaentry>
Expand All @@ -61,15 +61,15 @@ over NFS.
<qandaset>
<qandaentry>
<question>
<para>zfs share does not work</para>
<para><command>zfs share</command> does not work</para>
</question>
<answer>
<para>zfs share command does not export the filesystem marked
with sharenfs=on. The exporting is done at the time zfs set
sharenfs=on tank is executed. Since this internally invokes the
exportfs command the effects are equivalent if you chose to use
exportfs instead of zfs sharenfs=on to export. This current
limitation of "zfs share" not invoking exportfs will be fixed in
<para><command>zfs share</command> command does not export the filesystem marked
with sharenfs=on. The exporting is done at the time <command>zfs set
sharenfs=on <emphasis role="italic">dataset</emphasis> </command> is executed. Since this internally invokes the
<command>exportfs</command> command the effects are equivalent, if you chose to use
<command>exportfs</command> instead of <command>zfs sharenfs=on</command> to export.
This current limitation of "zfs share" not invoking exportfs will be fixed in
a minor patch release.</para>
</answer>
</qandaentry>
Expand All @@ -86,18 +86,18 @@ over NFS.
</answer>
</qandaentry>
<qandaentry>
<question> <para> filesystem exported via /etc/fstab doesn't show
<question> <para> Filesystem exported via /etc/fstab doesn't show
correctly on client</para>
</question>
<answer><para>Depending on your setup the nfs exports might happen
before the zfs filesystems are mounted. This would result in
mountpoints for the ZFS filesystems being exported
instead. Unexport and re-export the /etc/fstab entries</para>
instead. Unexport and re-export the /etc/fstab entries.</para>
</answer>
</qandaentry>
</qandaset>
</sect1>
<sect1><title>other linux features</title>
<sect1><title>Other Linux features</title>
<qandaset>
<qandaentry>
<question> <para>io_submit(2) libaio.h</para>
Expand All @@ -111,20 +111,20 @@ over NFS.
</sect1>
</chapter>

<chapter><title>Instalation Guide</title>
<chapter><title>Installation Guide</title>
<sect1><title>Download The Binaries</title>

<para>To download &KQS; please visit our website <ulink
<para>To download &KQS;, please visit our website <ulink
url="http://www.kqstor.com/">http://www.kqstor.com/</ulink> and
download the tar.gz file appropriate for your distribution and kernel
version. The direct link to download is <ulink
url="http://www.kqstor.com/download">here</ulink>. The name of the tar.gz file
indicates the Distribution, the distro version and the kernel version
indicates the distribution, the distro version and the kernel version
for which these files are built. For example consider file
"Deb_Package_Ubuntu10.4_2.6.32-25-server.tar.gz" or
"Deb_Package_Ubuntu10.10_2.6.35-22-server.tar.gz" or
"zfs-fedora-2.6.35.6-48.fc14.x86_64.tar.gz". The former is for Ubuntu
10.04 running kernel 2.6.32-35 while the later is for Fedore 14
running linux kernel 2.6.35.6-48.</para>
10.10 running kernel 2.6.35-22 while the later is for Fedora 14
running Linux kernel 2.6.35.6-48.</para>
<para> The tar.gz provided contains native packages for your
distribution built against the supported kernel. These packages might
have dependencies on other packages part of the distribution which
Expand Down Expand Up @@ -216,16 +216,22 @@ spl 118572 6 lzfs,zfs,zcommon,znvpair,zavl,zunicode
<title>ZFS Support</title>
<sect1>
<title>User Registration.</title>
<para> Vistit http://kqstor.com/ for user registration. Fill necessary information during registration and you will get activation mail. Make sure that email you have used during registration is valid and is in use. Otherwise, you won&apos;t be able to activate your account.</para>
<para>Once you get registration mail, click the given url in your mail to activate your account. Once account is activated , you will be able to view your profile, modify your profile, buy license etc.</para>
<para> Visit http://kqstor.com/ for user registration. Fill necessary
information during registration. After submitting you will get an
activation mail. Make sure you use the correct email-id during
registration else, you won&apos;t be able to activate your account.</para>
<para>Once you get registration mail, click the given url to activate
your account. Once activated, you will be able to view/modify your
profile, buy licenses etc.</para>
</sect1>
<sect1>
<title>Getting support.</title>
<para>For getting support regarding any ZFS issue you should have purchased at least one license for your machine. Your license membership can be Silver, Gold or Platinum depending on your choice. You will get support as per your license membership.</para>
<para>For better support purchase one of the given license. For purchasing support click on &quot;buy support&quot; in download tab. Make sure that you are purchasing license as per your need.</para>
<para>For purchasing license you need to be registered user first.</para>
<para>To get the support on any ZFS issue, you should have a valid
licencse. Depending on your need you can buy Silver, Gold or Platinum
License. For more information please visit : http://kqinfo.com </para>
<para>Once you purchase support license you will get mail regarding license credentials. Keep you license credentials secure to avoid misuse of your license. </para>
<para>After purchasing license you should register your machine with KQ Infotech support system. To do that please follow the steps below: </para>
<para>After purchasing license you should register your machine with KQ
Stor support system. To do that please follow the steps mentioned below: </para>
<para><emphasis role="bold">
<emphasis role="underline">Registration :</emphasis>
</emphasis></para>
Expand All @@ -234,51 +240,68 @@ spl 118572 6 lzfs,zfs,zcommon,znvpair,zavl,zunicode
<para>Get the email-id that you have used during user registration. (*edi)</para>
</listitem>
<listitem>
<para>Get the password that you user for your account login. (*pswd)</para>
<para>Get the password that you use for your account login. (*pswd)</para>
</listitem>
<listitem>
<para>Get you product key that you got with your support license purchase. (*pkey)</para>
<para>Get the product key that you got with your support license purchase. (*pkey)</para>
</listitem>
<listitem>
<para>Login to superuser on your system and execute following at command line.</para>
<para><emphasis role="bold">$&gt; zfs_manage.py -u *edi -p *pswd -k *pkey</emphasis> <emphasis role="bold">--register</emphasis></para>
<para><command> zfs_manage.py -u *edi -p *pswd -k *pkey
--register</command></para>
</listitem>
<listitem>
<para>If the credentials you have provided are correct then you will get response with &quot;Machine registered successfully&quot; otherwise it will echo with some error message .</para>
<para>If the credentials you have provided are correct then you will
get response with &quot;Machine registered successfully&quot;
otherwise it will exit with some error message .</para>
</listitem>
<listitem>
<para>If <emphasis role="bold">zfs_manage.py</emphasis> is not available then make sure that you have installed ZFS package properly. </para>
<para>If <command>zfs_manage.py</command> is not available then make
sure that you have installed ZFS package properly.</para>
</listitem>
<listitem>
<para><emphasis role="bold">zfs_manage.py</emphasis> may need some additional package. So if these packages are not available then it will echo with error message indicating package unavailability. If it is the case then try to install that package manually.</para>
<para><command>zfs_manage.py</command> may need some additional
package. So, if these packages are not available then it will exit
with error message, indicating package unavailability.
If it is the case then try to install that package manually.</para>
</listitem>
<listitem>
<para>Once you get echo message about successful machine registration, you will be able to get support.</para>
<para>Once you get the message about successful machine registration, you will be able to get support.</para>
</listitem>
</itemizedlist>
<para><emphasis role="bold">
<emphasis role="underline">support :</emphasis>
<emphasis role="underline">Support :</emphasis>
</emphasis></para>
<itemizedlist>
<listitem>
<para>For getting support you have you have to execute the same command line as for registration by changing <emphasis role="bold">--register</emphasis> option to <emphasis role="bold">--supprt.</emphasis></para>
<para>To get the support you have you have to execute the same
command you used for registration.You just need to change <emphasis
role="bold">--register</emphasis> option to <emphasis
role="bold">--support.</emphasis></para>
</listitem>
<listitem>
<para>Follow the instruction given after the execution of the command line. It will ask you to mail to support@kqinfotech.com with dumpxml file exported and Sysreport.tar.gz by command line as an attachment and subject as <emphasis role="bold">support</emphasis></para>
<para>Follow the instructions given after the execution of the
command line. It will ask you to mail to the generated files
to<emphasis role="bold"><emphasis role="italic">
support@kqinfotech.com.</emphasis></emphasis></para>
</listitem>
<listitem>
<para>If you find any problem the you can contact to support@kqinfotech.com</para>
<para>If you find any problem then you can contact to <emphasis
role="bold"><emphasis
role="italic">support@kqinfotech.com</emphasis></emphasis></para>
</listitem>
</itemizedlist>
<para><emphasis role="bold">
<emphasis role="underline">un-registration :</emphasis>
<emphasis role="underline">Un-registration :</emphasis>
</emphasis></para>
<itemizedlist>
<listitem>
<para>For un-registration you have you have to execute the same command line as for registration by changing <emphasis role="bold">--register</emphasis> option to <emphasis role="bold">--unregister</emphasis></para>
</listitem>
<listitem>
<para>Follow the instruction given after the execution of the command line. It will ask you to mail to support@kqinfotech.com with dumpxml file exported by command line as an attachment and subject as <emphasis role="bold">unregister</emphasis>.</para>
<para>Follow the instructions given after the execution of the
command line. It will ask you to mail to the generated files to
support@kqinfotech.com.</para>
</listitem>
</itemizedlist>
</sect1>
Expand Down

0 comments on commit 93f54f6

Please sign in to comment.