SMART Ntebk 11 Linux perating systems Installatin and administratin guide
Prduct registratin If yu register yur SMART prduct, we ll ntify yu f new features and sftware upgrades. Register nline at smarttech.cm/registratin. Keep the fllwing infrmatin available in case yu need t cntact SMART Supprt. Serial number: Date f purchase: Trademark ntice SMART Bard, SMART Ntebk, smarttech, the SMART lg and all SMART taglines are trademarks r registered trademarks f SMART Technlgies ULC in the U.S. and/r ther cuntries. Linux is a registered trademark f Linus Trvalds. Debian is a registered trademark f Sftware in the Public Interest, Inc. RPM is a trademark r registered trademark f Red Hat, Inc. All ther third-party prduct and cmpany names may be trademarks f their respective wners. Cpyright ntice 2014 SMART Technlgies ULC. All rights reserved. N part f this publicatin may be reprduced, transmitted, transcribed, stred in a retrieval system r translated int any language in any frm by any means withut the prir written cnsent f SMART Technlgies ULC. Infrmatin in this manual is subject t change withut ntice and des nt represent a cmmitment n the part f SMART. This prduct and/r use theref cvered by ne r mre f the fllwing U.S. patents. www.smarttech.cm/patents 02/2014 smarttech.cm/kb/170339
Cntents Chapter 1: Installing SMART Ntebk 11 fr Linux 1 System requirements 1 Linux distributins tested 2 Installatin packages 2 Befre installing SMART Ntebk sftware 3 Chapter 2: Installing SMART Ntebk 11 sftware frm Debian packages 5 Intrductin 5 Dwnlading SMART Ntebk sftware Debian packages 6 Abut the Debian archive 7 Installing a package set 8 Editing the custmizatin file 9 Installing a Debian archive 9 Custmizing the installatin 13 Installatin 16 Chapter 3: Installing SMART Ntebk 11 sftware frm RPM packages 19 Intrductin 19 Dwnlading SMART Ntebk sftware RPM packages 20 Befre yu start 20 Abut installing the RPM package 22 Abut custmizatin 23 Installing an RPM package set 23 Custmizing the RPM installatin 24 Installatin 27 i smarttech.cm/kb/170339
Chapter 1 Installing SMART Ntebk 11 fr Linux System requirements 1 Linux distributins tested 2 Installatin packages 2 Debian packages 2 RPM Packages 2 Befre installing SMART Ntebk sftware 3 Obtaining a prduct key 3 System requirements Pentium 4 r higher prcessr 1 GB f RAM (2 GB recmmended) 2.5 GB f free hard disk space fr minimum installatin Linux kernel 2.6.31 r later X Windw System 11 release 6 (X11R6) r later that supprts XRender and Xinerama glibc 2.10.1 libstdc++6 GNOME 2.28 r KDE 4.3.5 libraries r later (recmmended) 1 smarttech.cm/kb/170339
C H A P T E R 1 Installing SMART Ntebk 11 fr Linux Linux distributins tested Debian 7.2 Ubuntu 12.04.3 LTS pensuse 11.4 N O T E 64-bit Linux distributins aren t supprted. If yur cmputer desn t meet these requirements, yu might need t install an earlier versin f SMART Ntebk cllabrative learning sftware. Visit smarttech.cm/supprt fr details. Installatin packages Yu can install SMART Ntebk 11 sftware fr Linux perating systems using ne f the fllwing: Debian packages RPM packages Debian packages Debian packages cntaining SMART Ntebk sftware and SMART Prduct Drivers are available. Debian packages are designed t allw autmated, silent and unattended deplyment ver the netwrk frm a central lcatin t remte target cmputers. This includes sftware pre-activatin, as well as lcal/distributed mirrring f Gallery material. RPM Packages RPM packages cntaining SMART Ntebk sftware and SMART Prduct Drivers are als available. Like Debian packages, RPM packages are designed t allw autmated, silent and unattended deplyment ver the netwrk frm a central lcatin t remte target cmputers. This includes sftware pre-activatin, as well as lcal/distributed mirrring f Gallery cntent. 2 smarttech.cm/kb/170339
C H A P T E R 1 Installing SMART Ntebk 11 fr Linux Befre installing SMART Ntebk sftware Befre yu install SMART Ntebk 11 sftware, yu must btain a prduct key. Obtaining a prduct key T btain a prduct key 1. G t smarttech.cm/nb10prductkey. 2. Type yur SMART prduct s serial number, chse yur rganizatin type, and then click Cntinue. 3. Fill ut the custmer infrmatin frm. 4. Cntinue the dwnlad and installatin prcedures while yu wait fr SMART t e-mail yu a prduct key. During the installatin, use the prduct key yu receive t activate yur sftware. N O T E S Yu can activate every cpy f SMART Ntebk 11 sftware using the same prduct key. Until yu activate the sftware, yu have nly a 30-day trial versin. 3 smarttech.cm/kb/170339
Chapter 2 Installing SMART Ntebk 11 sftware frm Debian packages Intrductin 5 Dwnlading SMART Ntebk sftware Debian packages 6 Abut the Debian archive 7 Befre yu start 7 Installing a package set 8 Editing the custmizatin file 9 Installing a Debian archive 9 Dwnlading SMART Ntebk sftware Debian archive 10 Verifying the integrity f the packages 11 Fllwing the validatin prcess 11 Editing the custmizatin file 12 Installing the archive 12 Custmizing the installatin 13 Setting up yur server fr Gallery dwnlads 14 Custmizing the packages 15 Dependencies 15 Installatin 16 Envirnment variables 16 Remving the sftware 17 Intrductin This sectin shws hw yu can install SMART Ntebk sftware and SMART Prduct Drivers sftware shipped as Debian package files. I M P O R T A N T Befre yu install SMART Ntebk 11 sftware, yu must btain a prduct key. See Befre installing SMART Ntebk sftware n page 3. 5 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Dwnlading SMART Ntebk sftware Debian packages T dwnlad SMART Ntebk 11 sftware 1. G t smarttech.cm/dwnlads. 2. In the SMART Ntebk cllabrative learning sftware area, select Chse a versin, and then select 11 fr Linux frm the drp-dwn list. 3. Select the Dwnlad Debian packages sectin, and then click Dwnlad next t Debian plain files. 4. Fill ut the Dwnlad Sftware frm, and then click Start Dwnlad. The end user license agreement (EULA) appears. 5. Accept the end user license agreement (EULA) A file dwnlad dialg bx appears. 6. Select Save File, and then click OK. 7. Brwse t where yu want t save the file, and then click Save. The Dwnlad Cmplete dialg bx appears. 8. Click Clse. 9. Brwse t where yu saved the file, and then duble-click SMART_sftware_deb_files.tar.gz. Yur file cmpressin prgram pens. 10. Decmpress SMART_sftware_deb_files.tar.gz, and then brwse t the decmpressed flder. 6 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Abut the Debian archive The SMART_sftware_deb_files.tar.gz archive cntains Debian installatin packages fr SMART Ntebk sftware and SMART Prduct Drivers, as well as a custmizatin template file. T prepare the packages fr use, yu must perfrm the fllwing steps: Verify the integrity f the files yu received. Obtain a prduct key. See Befre installing SMART Ntebk sftware n page 3. Select a master signing key t sign the relevant data with the GNU Privacy Guard (GPG). Edit the custmizatin template file t include yur prduct key and yur GPG key ID, t select the cntent galleries yu wish, etc. Execute the autmated prcedure that merges the custmizatin infrmatin int the packages. I M P O R T A N T T activate yur sftware fr a silent remte deplyment and t custmize the installatin, yu must edit the custmizatin file named custmizatin befre yu install the sftware. The installatin data can be shipped in tw frms: package set r Debian archive. Befre yu start Ensure that the packages dpkg, dpkg-dev, dpkg-deb and binutils are installed. Yu als need GPG, md5sum, sha1sum, sha256sum and utilities like sed, cut and tr. 7 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Installing a package set SMART prvides an archive named SMART_sftware_deb_files.tar.gz cntaining the fllwing: eight Debian package files smart-cmmn_<versin>_i386.deb smart-hwr_<versin>_i386.deb smart-languagesetup_<versin>_i386.deb smart-activatin_<versin>_i386.deb smart-gallerysetup_<versin>_i386.deb smart-ntebk_<versin>_i386.deb smart-prduct-drivers_<versin>_i386.deb nwfermi-<versin>_i386.deb (fr SMART Bard 480 interactive whitebards nly) eight crrespnding integrity infrmatin files smart-cmmn_i386_sha256sum.asc smart-hwr_i386_sha256sum.asc smart-languagesetup_i386_sha256sum.asc smart-activatin_i386_sha256sum.asc smart-gallerysetup_i386_sha256sum.asc smart-ntebk_i386_sha256sum.asc smart-prduct-drivers_i386_sha256sum.asc nwfermi_i386_sha256sum.asc the swbuild.asc file cntaining the public key t use fr checking the signature the key ID is 7DD63D3B the fingerprint is 2907 DB4C CC5D 44D8 3694 5F8A BB8D 4237 7DD6 3D3B a validate.sh script a custmizatin file a custmize.sh script 8 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages T verify the integrity f the packages, keeping all the files in the current wrking directry 1. Imprt the key frm swbuild.asc t GPG, and then find the fingerprint. 2. Cnfirm the fingerprint with SMART r yur authrized SMART reseller. 3. Sign the key with yur wn ultimately trusted key. 4. Execute the cmmand./validate.sh files. Yu can check the n-screen utput t verify the integrity f the package files. Editing the custmizatin file After yu verify the packages, yu can edit the custmizatin file. The file cntains script variables, which are explained by the cmments that precede them. T perfrm a remte silent mass deplyment, yu must insert the prduct key yu received frm SMART. Yu can als select the gallery cmpnents yu want t make available. After yu mdify the custmizatin file, execute custmize.sh files. This mdifies all the DEB package files by inserting the cntents f the custmizatin file int the maintainer scripts f each package. The ASC integrity files are remade and signed with the key yu specified n the SMART_ ARCHIVE_KEY line in the custmizatin file. If yu dn t define the key in SMART_ARCHIVE_ KEY, the current user s default key is used fr signing. After yu custmize all the packages, yu can install them with dpkg -i, r yu can insert them int yur particular deplyment system. Installing a Debian archive The archive named SMART_sftware_deb_rep.tar.gz can be dwnladed (see Dwnlading SMART Ntebk sftware Debian archive n the next page) and cntains the fllwing: the linear directry tree dists -> stable -> nn-free -> binary-i386, where the last directry (binaryi386) cntains eight Debian package files smart-cmmn_<versin>_i386.deb smart-hwr_<versin>_i386.deb smart-languagesetup_<versin>_i386.deb smart-activatin_<versin>_i386.deb smart-gallerysetup_<versin>_i386.deb smart-ntebk_<versin>_i386.deb 9 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages smart-prduct-drivers_<versin>_i386.deb nwfermi-<versin>_i386.deb (fr SMART Bard 480 interactive whitebards nly) N O T E S The stable and binary-i386 directries cntain Debian archive metadata. The custmizatin script prvided recnstructs part f this metadata after mdifying the packages themselves. the swbuild.asc file cntaining the public key t use fr checking the signature. Yu shuld als be able t imprt this key directly frm the key servers. Our key ID is 7DD63D3B and the fingerprint is 2907 DB4C CC5D 44D8 3694 5F8A BB8D 4237 7DD6 3D3B. a validate.sh script a custmizatin file a custmize.sh script Dwnlading SMART Ntebk sftware Debian archive T dwnlad SMART Ntebk 11 sftware 1. G t smarttech.cm/dwnlads. 2. In the SMART Ntebk cllabrative learning sftware area, select Chse a versin, and then select 11 fr Linux frm the drp-dwn list. 3. Select the Debian Dwnlads sectin, and then click Dwnlad next t Debian prepackaged repsitry. 4. Fill ut the Dwnlad Sftware frm, accept the end user license agreement (EULA) and then click Start Dwnlad. The Dwnlad Cnfirmatin page appears, and then the File Dwnlad dialg bx appears. 5. Click Save. 6. Brwse t where yu want t save the file, and then click Save. The Dwnlad Cmplete dialg bx appears. 7. Click Clse. 8. Brwse t where yu saved the file, and then duble-click SMART_sftware_deb_rep.tar.gz. Yur file cmpressin prgram pens. 10 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages 9. Decmpress SMART_sftware_deb_rep.tar.gz, and then brwse t the decmpressed flder. Verifying the integrity f the packages Verify the integrity f the packages, keeping all these files in the current wrking directry. T verify the integrity f the packages directry 1. Imprt the key frm swbuild.asc t GPG, and then find the fingerprint. 2. Cnfirm the fingerprint with SMART r yur authrized SMART reseller. 3. Sign the key with yur wn ultimately trusted key. 4. Execute the cmmand./validate.sh archive t verify the integrity f the package files yu have received, and then check the utput. Fllwing the validatin prcess If yu want t fllw the validatin prcess, yu can use the cmmand bash -x validate.sh archive. The fllwing is an verview f that prcess. T reprduce the validatin prcess 1. cd t dists/stable. 2. Check the Release file with this cmmand: gpg --verify Release.gpg Release 3. Check the Packages metadata files under binary-i386 with these cmmands: cat Release tr -s ' ' cut -d' ' --fields=2,4 sed 's% % %' > t sha256sum -c t This checks the nn-free/binary-i386/packages.* files. 4. cd t nn-free/binary-i386. 5. Check the actual package files using the Packages file with these cmmands: grep MD5sum Packages > a dpkg-scanpackages.../../smart.verride grep MD5sum > b diff a b 11 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages If the files are the same, the last cmmand desn t prduce an utput. If a line is different, then that line identifies a crrupt package file. In the Packages file, find the line that begins with MD5sum, and tw lines abve it, the line that begins with Filename identifies the crrupt package file. The script displays the names f packages discvered in this way. Editing the custmizatin file After yu verify the packages, yu can edit the custmizatin file placed utside dists. The file cntains script variables, which are explained by the cmments that precede them. T perfrm a remte silent mass deplyment, yu must insert the prduct key yu received frm SMART. Yu can als select the Gallery cmpnents yu want t make available. Yu need yur wn archive key ID t re-sign the main Release file, and yu shuld assign it t SMART_ARCHIVE_KEY. After yu mdify the custmizatin file, execute./custmize.sh. This mdifies all the DEB package files by inserting the cntents f the custmizatin file int the maintainer scripts f each package. Then it rebuilds the archive metadata, recalculates the integrity checksums and signs the main Release file. Sign the new Release file with yur wn archive key by editing the SMART_ARCHIVE_KEY line in the custmizatin file with yur key ID. If yu dn t define the key in SMART_ARCHIVE_KEY, the current user s default key is used fr signing. Installing the archive After yu custmize the packages and rebuild the Debian archive, yu can cpy all f the files int the dcument tree f yur web server. Befre yu can install the packages with apt-get install, yu must update the package list n each target cmputer. T update the list f custmized packages t each cmputer 1. Add a ne-line file named smart.list under /etc/apt/surces.list.d/ t identify the archive. It shuld cntain the fllwing: deb http://webservername/myflder/ stable nn-free where myflder stands fr the directry int which yu have cpied dists in the dcument tree f the web server. OR If yu aren t using a web server, use the fllwing line in the file: deb file:/hme/swbuild/myflder/ stable nn-free 12 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages 2. Add the necessary public key t the apt system using apt-key add <publickey>.asc. N O T E S If yu didn t edit the custmizatin file, the public key that verifies the integrity f the packages is the public key in swbuild.asc. If yu did edit the custmizatin file, the integrity infrmatin is rebuilt with anther private key. This key is defined n the SMART_ARCHIVE_KEY line in the custmizatin file. Yu must exprt the crrespnding public key t an ASCII file, and then specify that file. 3. Execute apt-get update. N O T E In Synaptic, g t Settings/Repsitries, select the Third Party Sftware tab, click Add, type ne f the tw lines abve that starts with deb http r deb file, and then click the Relad buttn n the tlbar. This adds a new surce line at the end f /etc/apt/surces.list. 4. Install the sftware by executing apt-get install smart-prduct-drivers smart-ntebk. Custmizing the installatin Fr the prcedures in this sectin, assume the fllwing: Yur website is http://myweb.cmpany.cm. The dcument rt f yur server is /var/www. The Gallery data will be in /var/www/efe, accessed as http://myweb.cmpany.cm/efe. When yu custmize the installatin, yu can d the fllwing: Prvide the SMART Ntebk sftware prduct key fr autmatic activatin. Install SMART Ntebk sftware, SMART Prduct Drivers r bth. Disable the autmatic start f SMART Bard Service and SMART Bard Tls. 13 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Custmize the installatin f Gallery Essentials, including the fllwing: selecting individual categries installing the Gallery frm previusly dwnladed surce installing the Gallery in a custmized lcatin registering a previusly installed Gallery, such as a Gallery n a shared netwrk registering Team Cntent selecting a surce URL fr dwnlading Gallery cntent, s that yu can set up Gallery cntent n yur wn web server as a dwnlad surce. Setting up yur server fr Gallery dwnlads After setup, yu can dwnlad Gallery cntent. T set up yur web server 1. Make a /var/www/efe directry t receive the cntent. 2. Install the custmized packages in the default lcatin with their default Gallery surce URL (currently http://dwnlads01.smarttech.cm/sftware/efe/). 3. Dwnlad the data t its intended lcatin with these cmmands: /pt/smart Technlgies/Gallery Setup/bin/GallerySetup \ --dwnladall \ --destinatin /var/www/efe \ --cnfiguratin /pt/smart Technlgies/Gallery Setup/share/ SMARTEssentials.gallerycllectin 4. Use a brwser t check yur web server and check that yu see a lng list f files ending in.gallery r in.zip. 14 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Custmizing the packages T use yur new dwnlad surce yu must custmize the packages. T custmize the packages 1. In the custmizatin file, edit the fllwing line, making sure it isn t cmmented. exprt CONTENT_LOCAL_URL=http://myweb.cmpany.cm/efe 2. Add yur ther custmizatins. 3. Execute custmize.sh. 4. Install the custmized packages. Messages like the fllwing ne indicate that yur web server cnnectin is checked: Checking cnnectin t: http://myweb.cmpany.cm/efe Check succeeded The selected Gallery cmpnents are dwnladed and installed. N O T E T revert t the riginal dwnlad surce that came built int the sftware, cmment ut the CONTENT_LOCAL_URL line, and then execute custmize.sh again. Dependencies The tw main packages are smart-ntebk and smart-prduct-drivers; the ther five are their dependencies. Main package Dependencies smart-ntebk_<versin>.i686.deb smart-cmmn smart-hwr smart-languagesetup smart-activatin smart-gallerysetup smart-prduct-drivers_<versin>.i686.deb smart-cmmn smart-hwr smart-languagesetup 15 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Installatin T install package sets, use a dpkg --install cmmand. E X A M P L E dpkg --install smart-cmmn_10.2.286.0-1_i386.deb T install archives accessed ver a netwrk, use an apt-get install cmmand. E X A M P L E apt-get install smart-cmmn N O T E S After yu make changes t the nline archive, run apt-get update n the target cmputers. Using an apt-get cmmand installs dependencies. Fr example, if yu run apt-get install smart-prduct-drivers smart-ntebk yu install all seven f the SMART packages. Envirnment variables Yu can set the fllwing envirnment variables t fllw the installatin prgress (they re intended fr use with dpkg). Variable Lgging Tracing Bypassing package scripts Use Set DEB_MAINTAINER_LOG t a value, and DEB_MAINTAINER_ LOGPATH t the desired path. The maintainer scripts in the packages then lg the installatin and remval events t a file named smart_ debian_install.lg under the specified path. Set DEB_DEBUG_SCRIPTS t a value befre installing r remving the sftware. The package scripts execute with set -x with the usual screen utput. If the scripts fail s severely that they prevent yu frm installing r remving the sftware, yu can bypass them while purging. Fr example, yu can remve the package in this way: env DEB_MAINTAINER_NOSCRIPTS=1 dpkg --purge smartcmmn 16 smarttech.cm/kb/170339
C H A P T E R 2 Installing SMART Ntebk 11 sftware frm Debian packages Remving the sftware When yu installed the sftware, it was cpied int the /pt/smart Technlgies flder. Other files are placed in /etc/xdg, /etc/udev/rules.d, /usr/share (such as dc, man/man1, icns/ hiclr, pixmaps/hiclr, applnk, mimelnk/applicatin), /usr/lcal/share/applicatins and $HOME/.cnfig. Mst files are remved during the package remval prcess, but the fllwing files remain: glbal cnfiguratin files /etc/xdg/smart Technlgies/*.cnf /etc/xdg/smart Technlgies.cnf activatin data /pt/smart Technlgies/cmmn/data/.mp.1.1.dat /pt/smart Technlgies/cmmn/data/.vp.1.1.dat MIME XML files wherever they re installed files created in the current user s hme under $HOME/.cnfig 17 smarttech.cm/kb/170339
Chapter 3 Installing SMART Ntebk 11 sftware frm RPM packages Intrductin 19 Dwnlading SMART Ntebk sftware RPM packages 20 Befre yu start 20 Abut installing the RPM package 22 Abut custmizatin 23 Befre yu start 23 Installing an RPM package set 23 Verifying the integrity f the packages 24 Custmizing the RPM installatin 24 Setting up yur server fr Gallery dwnlads 25 Custmizing the packages 26 Dependencies 26 Installatin 27 Envirnment variables 28 Web repsitries 29 Making a repsitry 29 Installing packages frm the repsitries 29 Remving the sftware 31 Intrductin This sectin shws hw yu can install SMART Ntebk sftware and SMART Prduct Drivers sftware shipped as RPM package files. I M P O R T A N T Befre yu install SMART Ntebk 11 sftware, yu must btain a prduct key. See Befre installing SMART Ntebk sftware n page 3. 19 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Dwnlading SMART Ntebk sftware RPM packages T dwnlad SMART Ntebk 11 sftware 1. G t www.smarttech.cm, select Supprt, and then select Dwnlads. 2. In the SMART Ntebk cllabrative learning sftware area, select Chse a versin, and then select 11 fr Linux frm the drp-dwn list. 3. Select the Dwnlad RPM packages sectin, and then click Dwnlad next t RPM plain files. 4. Fill ut the Dwnlad Sftware frm, accept the EULA and then click Start Dwnlad. The Dwnlad Cnfirmatin page appears, and then the File Dwnlad dialg bx appears. 5. Click Save. 6. Brwse t where yu want t save the file, and then click Save. The Dwnlad Cmplete dialg bx appears. 7. Click Clse. 8. Brwse t where yu saved the file, and then duble-click SMART_sftware_rpm_files.tar.gz. Yur file cmpressin prgram pens. 9. Decmpress SMART_sftware_rpm_files.tar.gz, and then brwse t the decmpressed flder. Befre yu start On sme platfrms yu must install perl-mail-sendmail, prviding perl(mail::sendmail). Yu als need rpmbuild (in package rpm r rpm-build) rpm2cpi (prbably in rpm) cpi expect If yu want t put the packages in a web repsitry, yu als need the Pythn script createrep. 20 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Yu need t have GPG cnfigured, with a secret key generated and set as the default-key in ~/.gnupg/gpg.cnf. Yu must imprt the public key t RPM t check the released packages. T imprt the key, execute as rt: rpm --imprt swbuild.asc T check a package file, execute: rpm --checksig smart-whatever.i686.rpm N O T E The utput line must end in gpg OK. Yu must imprt the public key t GPG and sign it t use a zypper repsitry. T imprt it, use: gpg --imprt swbuild.asc T sign it, use: gpg --sign-key 7DD63D3B N O T E The SMART key will be signed with yur default key. Yu must place the public key in /etc/pki/rpm-gpg t use a yum repsitry. Yu need a file named ~/.rpmmacrs, which must include the fllwing: %_tpdir <sme tpdir> %_signature gpg %_gpg_path /hme/<accuntname>/.gnupg %_gpg_name <key id> Where: <accuntname> is the user name yu use t run the custmizatin. Yu dn t need t be rt t custmize. 21 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages <sme tpdir> is a directry t where yur accunt can write, r t a directry that yu ll make. Use an abslute path. The custmize script will parse the.rpmmacrs file and extract that path. That is where the new package files will be built befre being mved back t the cwd. <key id> is the descriptin string f the key yu will use t sign the custmized packages, as displayed by gpg --list-secret-keys. E X A M P L E %_tpdir /hme/swbuild/rpmbuild %_signature gpg %_gpg_path /hme/swbuild/.gnupg %_gpg_name SMART Technlgies (Build and Install Grup) Abut installing the RPM package The archive cntains RPM installatin packages fr SMART Ntebk sftware and SMART Prduct Drivers, as well as a custmizatin template file. T prepare the packages fr use, yu must perfrm the fllwing steps, which are explained in detail belw: Prvide the prerequisites detailed abve. Verify the integrity f the files yu received. Obtain a prduct key, either nline frm SMART r frm yur authrized SMART reseller. See Befre installing SMART Ntebk sftware n page 3. Select a master signing key t use fr signing the relevant data with GPG (the abve steps can happen in any rder). Edit the custmizatin template file t insert yur prduct key, t select the cntent galleries yu want, etc. Execute the autmated prcedure that merges the custmizatin infrmatin int the packages. Optinally, place the custmized packages in a web repsitry and cnfigure client machines. 22 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Abut custmizatin I M P O R T A N T In rder t activate yur sftware fr a silent unattended netwrk deplyment and t custmize the installatin, yu must edit the custmizatin file named custmizatin befre yu install the sftware. The installatin data is shipped as a package set, which includes instructins fr making a web repsitry accessible with yum r zypper and fr cnfiguring client cmputers. Befre yu start Ensure that the packages rpm, cpi, expect and createrep are installed. Yu als need GPG and utilities like sed, cut and tr. Installing an RPM package set SMART prvides an archive named SMART_sftware_rpm_files.tar.gz cntaining the fllwing: ten RPM package files smart-cmmn_<versin>.i686.rpm smart-hwr_<versin>.i686.rpm smart-languagesetup_<versin>.i686.rpm smart-activatin_<versin>.i686.rpm smart-gallerysetup_<versin>.i686.rpm smart-ntebk_<versin>.i686.rpm smart-prduct-drivers_<versin>.i686.rpm nwfermi-<versin>-i386.rpm (fr SMART Bard 480 interactive whitebards, nly) nwfermi_kernel_default_devel-<versin>.i686.rpm (fr Linkat) dkms-<versin>.narch.rpm (dependency fr nwfermi) the swbuild.asc file cntaining the public key as the archive signing key the key ID is 7DD63D3B the fingerprint is 2907 DB4C CC5D 44D8 3694 5F8A BB8D 4237 7DD6 3D3B 23 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages a custmizatin file named custmizatin a script named custmize.sh Verifying the integrity f the packages Verify the integrity f the packages, keeping all f the files in the current wrking directry. T verify the integrity f the packages 1. Imprt the key frm swbuild.asc t GPG, and then find the fingerprint. 2. Cnfirm the fingerprint with SMART r yur authrized SMART reseller. 3. Sign the key with yur wn ultimately trusted key. 4. Imprt the key t rpm with rpm --imprt swbuild.asc. 5. Execute the cmmand rpm --checksig <package> fr every package file, where <package> dentes the package file. The utput fr each cmmand shuld end in gpg OK. After yu verify the packages, yu can edit the custmizatin file. The file cntains script variables, which are explained by the cmments that precede them. T perfrm a remte silent mass deplyment, yu must insert the prduct key yu received frm SMART. Yu can als select which gallery cmpnents yu want t make available After yu mdify the custmizatin file, execute./custmize.sh, which mdifies all the RPM package files by inserting the cntents f the custmizatin file int the maintainer scripts f each package. At this pint, the RPM package files are remade and signed with the key specified in.rpmmacrs. After yu custmize all the packages, yu can install them with rpm -i, r yu can insert them int yur particular deplyment framewrk. Custmizing the RPM installatin Fr the prcedures in this sectin, assume the fllwing: Yur website is http://myweb.cmpany.cm The dcument rt f yur server is /var/www The Gallery data will be in /var/www/efe, accessed as http://myweb.cmpany.cm/efe 24 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages When yu custmize the installatin, yu can d the fllwing: Prvide the SMART Ntebk sftware prduct key fr autmatic activatin. Install SMART Ntebk sftware, SMART Prduct Drivers r bth. Disable the autmatic start f SMART Bard Service and SMART Bard Tls. Custmize the installatin f Gallery Essentials, including the fllwing: selecting individual categries installing the Gallery frm previusly dwnladed surce installing the Gallery in a custmized lcatin registering a previusly installed Gallery, such as a Gallery n a shared netwrk registering Team Cntent selecting a surce URL fr dwnlading Gallery cntent, s that yu can set up Gallery cntent n yur wn web server as a dwnlad surce Setting up yur server fr Gallery dwnlads After setup, yu can dwnlad Gallery cntent. T set up yur web server 1. Make a /var/www/efe directry t receive the cntent. 2. Install the custmized packages in the default lcatin with their default Gallery surce URL (currently http://dwnlads01.smarttech.cm/sftware/efe/). 3. Dwnlad the data t its intended lcatin with these cmmands: /pt/smart Technlgies/Gallery Setup/bin/GallerySetup \ --dwnladall \ --destinatin /var/www/efe \ --cnfiguratin /pt/smart Technlgies/Gallery Setup/share/ SMARTEssentials.gallerycllectin 4. Use a brwser t check yur web server and check that yu see a lng list f files ending in.gallery r in.zip. 25 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Custmizing the packages T use yur new dwnlad surce yu must custmize the packages. T custmize the packages 1. In the custmizatin file, edit the fllwing line, making sure it isn t cmmented. exprt CONTENT_LOCAL_URL=http://myweb.cmpany.cm/efe 2. Add yur ther custmizatins. 3. Execute custmize.sh. 4. Install the custmized packages. Messages like the fllwing ne indicate that yur web server cnnectin is checked: Checking cnnectin t: http://myweb.cmpany.cm/efe Check succeeded The selected Gallery cmpnents are dwnladed and installed. N O T E T revert t the riginal dwnlad surce that came built int the sftware, cmment ut the CONTENT_LOCAL_URL line, and then execute custmize.sh again. Dependencies The tw main packages are smart-ntebk and smart-prduct-drivers; the ther five are their dependencies. Main package Dependencies smart-ntebk_<versin>.i686.rpm smart-cmmn smart-hwr smart-languagesetup smart-activatin smart-gallerysetup smart-prduct-drivers_<versin>.i686.rpm smart-cmmn smart-hwr smart-languagesetup 26 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Installatin T install package sets, use rpm -i. E X A M P L E rpm -i smart-cmmn_10.2.286.0-1.i686.rpm T install archives accessed ver a netwrk, use yum install, r zypper install. E X A M P L E yum install smart-cmmn zypper install smart-cmmn N O T E S After yu make changes t the nline archive, run yum update, r zypper refresh n the target cmputers. Running yum and zypper installs dependencies. Fr example, if yu run yum install smart-prduct-drivers smart-ntebk yu install all seven f the SMART packages. 27 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Envirnment variables Yu can set the fllwing envirnment variables t fllw the installatin prgress (they re intended fr use with RPM). Variable Lgging Tracing Bypassing package scripts Use Set RPM_MAINTAINER_LOG t a value, and RPM_MAINTAINER_ LOGPATH t the desired path. The maintainer scripts in the packages then lg the installatin and remval events t a file named smart_rpm_ install.lg in the specified path. Set RPM_DEBUG_SCRIPTS t a value befre installing r remving the sftware. The package scripts execute with set -x with the usual screen utput. If the scripts fail s severely that they prevent yu frm installing r remving the sftware, yu can bypass them while purging. Fr example, yu can remve the package in this way: env RPM_MAINTAINER_NOSCRIPTS=1 rpm --ndeps -e smart-cmmn N O T E Yu shuldn t need t d this, because yu can use the RPM -- nscripts flag. 28 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages Web repsitries Rather than installing packages lcally with RPM cmmands, yu can keep the same packages n a web server and install them using a client tl such as yum r up2date (Red Hat), r zypper r YaST (pensuse). Making a repsitry T make a repsitry 1. Create a directry t cntain yur repsitry and place all the package files in it. 2. cd t the directry, and then execute createrep. A subdirectry named repdata appears. 3. cd t repdata and check that the files filelists.xml.gz, ther.xml.gz, primary.xml.gz and repmd.xml were created. 4. Sign repmd.xml with gpg --clearsign repmd.xml. This creates the file repmd.xml.asc. 5. Exprt the public key paired with the secret yu have used fr signing (that wuld be yur default key ID specified in.gnupg/gpg.cnf) using gpg --armr --exprt <key-id> > repmd.xml.key. Yu can cpy yur repsitry directry int the dcument tree f any web server. Installing packages frm the repsitries Fr the fllwing prcedures, assume that the directry is myrep, and that yu placed it under rpm in a web server named mywww. The URL f the repsitry is nw http://mywww/rpm/ myrep. T use yum t install packages frm the new repsitry 1. Create a file named mysurce.rep lking like this: [SMART Technlgies ULC] name=smart Technlgies Sftware baseurl=http://mywww/rpm/myrep gpgcheck=1 enabled=1 gpgkey=file:///etc/pki/rpm-gpg/archivekey.asc 2. Put the file in the /etc/yum.reps.d flder. 29 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages 3. Exprt the public key used fr signing int the file /etc/pki/rpm-gpg/archivekey.asc. 4. Execute yum update. Yu shuld see yur new repsitry being accessed, alng with previus nes, while yum updates the cached lists it keeps n the client cmputer. 5. Execute this cmmand: yum install smart-ntebk smart-prduct-drivers A message appears stating that seven packages will be installed. T use zypper t install packages frm the new repsitry 1. Create a file named mysurce.rep like this: [SMART Technlgies U.L.C.] name=smart Technlgies Sftware enabled=1 autrefresh=1 baseurl=http://mywww/rpm/myrep path=/ type=rpm-md keeppackages=0 2. Put it in the /etc/zypp/reps.d flder. 3. Retrieve the public key used fr signing using wget http://mywww/rpm/myrep/ repdata/repmd.xml.key. 4. Imprt it using gpg --imprt, find ut its ID using gpg --list-keys, and then sign it with yur default key using gpg --sign-key <key-id>. 5. Execute zypper refresh. Yu shuld see yur new repsitry being accessed, alng with previus nes, while zypper updates the cached lists it keeps n the client cmputer. 30 smarttech.cm/kb/170339
C H A P T E R 3 Installing SMART Ntebk 11 sftware frm RPM packages 6. Execute this cmmand: zypper install smart-ntebk smart-prduct-drivers A message appears stating that seven packages will be installed. N O T E A prepackaged repsitry can als be dwnladed by fllwing the instructins in Dwnlading SMART Ntebk sftware Debian archive n page 10. If yu use and custmize the packages, then yu must execute createrep as a last step. Remving the sftware When yu installed the sftware, it was cpied int the /pt/smart Technlgies flder. Other files are placed in /etc/xdg, /etc/udev/rules.d, /usr/share (such as dc, man/man1, icns/ hiclr, pixmaps/hiclr, applnk, mimelnk/applicatin), /usr/lcal/share/applicatins and $HOME/.cnfig. Mst files are remved during the package remval prcess, but the fllwing files remain: glbal cnfiguratin files /etc/xdg/smart Technlgies/*.cnf /etc/xdg/smart Technlgies.cnf activatin data /pt/smart Technlgies/cmmn/data/.mp.1.1.dat /pt/smart Technlgies/cmmn/data/.vp.1.1.dat MIME XML files wherever they re installed files created in the current user s hme under $HOME/.cnfig 31 smarttech.cm/kb/170339
SMART Technlgies smarttech.cm/supprt smarttech.cm/cntactsupprt smarttech.cm/kb/170339