SMART Notebook 11 software

SMART Ntebk 11 sftware INSTALLATION AND ADMINISTRATION GUIDE FOR LINUX OPERATING SYSTEMS

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 2015 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 12/2015 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 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 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 3.13 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

CHAPTER 1 INSTALLING SMART NOTEBOOK 11 FOR LINUX Linux distributins tested Ubuntu 14.04. LTS NOTE 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 Debian 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. 2 smarttech.cm/kb/170339

CHAPTER 1 INSTALLING SMART NOTEBOOK 11 FOR 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. NOTES 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. IMPORTANT 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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. IMPORTANT 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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 (binary-i386) 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM DEBIAN PACKAGES smart-prduct-drivers_<versin>_i386.deb nwfermi-<versin>_i386.deb (fr SMART Bard 480 interactive whitebards nly) NOTES 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM DEBIAN PACKAGES 2. Add the necessary public key t the apt system using apt-key add <publickey>.asc. NOTES 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. NOTE 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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. NOTE 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM DEBIAN PACKAGES Installatin T install package sets, use a dpkg --install cmmand. EXAMPLE dpkg --install smart-cmmn_10.2.286.0-1_i386.deb T install archives accessed ver a netwrk, use an apt-get install cmmand. EXAMPLE apt-get install smart-cmmn NOTES 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

CHAPTER 2 INSTALLING SMART NOTEBOOK 11 SOFTWARE FROM 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

SMART TECHNOLOGIES smarttech.cm/supprt smarttech.cm/cntactsupprt smarttech.cm/kb/170339