QStar Archive Manager Troubleshooting Q&A
Download 37.02 Kb.
|
- Navigate this page:
- How QStar Integral Volumes and CleverSafe Vaults relate
- Can I use same vaults form different computers
- Are QStar distributions compatible for different Linux versions
- In which directory I should install QStar Software
- How I extract QStar distribution
- How do I license QStar software
- How do I configure Cleversafe QSSD device
- How I define access to the vaults
- How do I create Integral Volume, add vaults and mount
- What libraries I need to install on Linux
- How to check that portmapper is installed
- How do I unmount IV set
- How I move QStar software to other computer
- What QStar processes should be running in UNIX systems
- How do I know that set is mounted and healthy
- How do I know that something is wrong
- How do I kill everything
- How do I know that data is communicated to Cleversafe
- What files I need to send to QStar in case of error
- How do I perform data base backup
QStar Archive Manager Troubleshooting Q&AChange History
ContentsQStar Archive Manager Troubleshooting Q&A 1 How QStar Integral Volumes and CleverSafe Vaults relate? 2 Can I use same vaults form different computers? 2 Are QStar distributions compatible for different Linux versions? 3 In which directory I should install QStar Software? 3 How I extract QStar distribution? 3 How I install QStar software? 3 How do I license QStar software? 4 How do I configure Cleversafe QSSD device? 4 How I define access to the vaults? 4 How do I create Integral Volume, add vaults and mount? 5 What libraries I need to install on Linux? 5 How to check that portmapper is installed? 6 How do I mount Integral Volume set ? 6 How do I unmount IV set? 6 How do I export QStar file system through NFS? 6 How I move QStar software to other computer? 7 What QStar processes should be running in UNIX systems? 8 How do I know that set is mounted and healthy? 9 What is Covered error? 9 How do I know that something is wrong? 9 How do I perform mounted set cleanup? 9 How do I kill everything? 9 How do I know that data is communicated to Cleversafe ? 10 What files I need to send to QStar in case of error? 10 How do I perform data base backup? 10 How QStar Integral Volumes and CleverSafe Vaults relate?The QStar Integral Volume (IV) presents a single file system which can be mounted, un-mounted or otherwise treated as a single namespace of the files with hierarchical structure. As mentioned before one IV is created on two CleverSafe Vaults – Metadata Vault and Data Vault. The files and file metadata of such file system are created and maintained on the cache disk and subsequently migrated to the CleverSafe storage in the form of objects. The objects are of 4-16 MB size and may contain data from a single file or from multiple small files. Can I use same vaults form different computers?The data sharing shall be performed on the IV set basis. The IV set mounted on some computer can be shared through NFS or CIFS to other computers. There is protection built in which allows to prevent CleverSafe vault pair sharing by some other IV on other computer. Technically this is possible to access vaults from any computer which can provide proper vault, user names and passwords. Unfortunately there is no tools to synchronize cache or vault modifications in consistent way. The protection processes attempts to mount the same vaults in the following way:
The “Clean cache”, Restore DB mount allows to recreate status of the system (possibly modified by the Node 1) at some point in time. During clean cache, Restore DB mount (which is essentially is the method to recover state of the file system after computer crash) the QStar will restore data base from the CleverSafe Vaults, replay objects after data base backup and repopulate CFS data base. Are QStar distributions compatible for different Linux versions?No. You need to request from QStar distribution build for compatible version of the Linux. RedHat builds usually are not compatible with Ubuntu, SuSe or other distributions. That is usually determined by libc and other libraries incompatibilities. 32 or 64 bit distribution flavors needs to be specified.
Symbolic links are supported in all platforms except AIX. How I extract QStar distribution?The distribution is delivered in the form of zipped tar file. You need to extract the file into directory /opt/QStar. mkdir –p /opt/QStar cd /opt/QStar tar xfz /tmp/linux_2.6_x86_64_v6.0.1.26xx.tar.gz How I install QStar software?The /opt/QStar/INSTALL script performs mandatory steps to install the software. cd /opt/QStar ./INSTALL Confirm license agreement. Select option 1. Select option 5. Select option 9 to exit.
Here is standard way to request for license. http://www.qstar.com/support/license-key-request-form/ You need to place received license file (names QStarLicenseFile.e58327eb) in /opt/QStar/license directory. How do I configure Cleversafe QSSD device?To make Cleversafe known to the QStar software it needs to be defined. qssddefine –T cs [-H hostname] –i iplistCluster –u usernameCluster –p passwordCluster qssdname This operation verifies that Cleversafe manager is accessible for the QStar software qssdrefresh qssdname This operation lists available Vaults. If vault access is configured they will be refreshed. qssdlist –av qssdname It list is empty please verify IP, username and password for the manager in qssddefine command How I define access to the vaults?Each vault which will be used in this installation needs to be configured separately. qssdmanage –T cs –i iplistVault -u username -p Password [-x proxy:port] qssdname VaultName Where: -i iplistVault - Comma separated list of the IP addresses or names of the vault. - u username – username for a Vault -p password – password for a Vault -x proxy:port - optional parameter if QStar server is behind the proxy server qssdname - Name of the CleverSafe QSSD device VaultName – name of the vault for which configuration is performed. qssdrefresh qssdname qssdlist –v qssdname You should see Vault parameters in the list and log/syslog shall not contain errors about access to the vault. How do I create Integral Volume, add vaults and mount?To create IV user following commands: vlcrset –T coud –u cs clever To add media to the IV set (assuming that metadata vault is called Meta-01 and data vault is called Data-01 and QSSD device is called qssdname) vladdtoset clever qssdname Meta-01 Data-01 To assign cache to the IV set ( assuming that cache will be located in /cache/clever directory): mkdir /cache/clever vlcache –c /cache/clever –p 10G clever Prepare mount point and mount mkdir /mnt/clever mountiv clever What libraries I need to install on Linux?QStar needs “portmapper”. For Ubuntu install: apt-get install nfs-kernel-server RedHat usually comes with portmapper. Ubuntu 112.04/ 11.10 require following library to be installed: apt-get install libicu-dev apt-get install uuid-dev
tcp 0 0 0.0.0.0:111 0.0.0.0:* LISTEN netstat –al |grep 111 How do I mount Integral Volume set ?mountiv setname is the command to use. Here setname is IV set name. In this document the setname will be defined as “clever”. There are following main options to use: mountiv –n clever - mounts set and cleans cache. The data will be retrieved from the Cleversafe if requested. Mountiv –Inf clever – recovers data base from Cleversafe and mounts with clean cache. There are several uses for this mount option. Testing is one. Clean everything is another. Moving IV set to other computer is third. Should be used when moving system to other computer. May take some time. Better if backup was forced before moving. How do I unmount IV set?umountiv clever In some cases (when acesser is not responding to TCP/IP requests) “forced” unmount may be needed: umountiv –f clever How do I export QStar file system through NFS?To export QStar file system (mounted as /mnt/clever) you need to create entry in /etc/exports file. The standard Linux syntax of the /etc/exports apply but there is one mandatory parameter to be added: fsid=xxxxxx. The fsid parameters value is not that important but every QStar file system (in fact every file system using FUSE driver) should have different value. For example: /mnt/clever *(rw,sync,insecure,no_subtree_check,no_root_squash,fsid=34) In this case value 34 was chosen. To activate new entry in /etc/fstab:
Please note that once you exported file system you will not be able to unmount QStar file system. It will return “busy” status until you un-export the file system from NFS. To un-export file system:
umountiv clever If original computer just died you may expect some data loss if data was remaining on the cache. The sequence of events shall be as following:
mountiv –Inf clever Here: -I – recover data base for Cleversafe storage -n – mount with clean cache -f - tell Cleversafe (properties object) that now this computer will be managing those vaults.
root 31823 31790 1 15:34 ? 00:00:00 qsetmount clever ps –ef |grep _ufsimount root 31866 1 0 15:34 ? 00:00:00 _ufsimount /mnt/clever /cache/clever clever CleverSafe 65536 8200 5968162150190827164 2 8 0 Following QStar servers should be running: ps –e |grep server 31445 ? 00:00:00 _qscsiserver 31447 ? 00:00:00 _jbserver 31451 ? 00:00:00 _mmserver 31453 ? 00:00:02 _vlserver 31465 ? 00:00:00 _fsi_server How do I know that set is mounted and healthy?If set is mounted and accessible the “mmparam clever” should show line Error condition No. If “Covered error” status is displayed the syslog shall be analyzed to understand error source. What is Covered error?Since QStar file system is represented by at least 2 software layers, from the user point of view the migrator software is “Covered” – i.e. not directly exposed – to the user. How do I know that something is wrong?
mmparam clever mmparam: common_socket.c.588: connect: Connection refused The ufsimount process or qsetmount process is down Perform mounted set cleanup. How do I perform mounted set cleanup?If something goes wrong the cleanup procesure involves following steps:
How do I kill everything?If normal start of the QStar servers is not working they can be killed explicitly: killall –KILL _qscsiserver _jbserver _mmserver _vlserver _fsi_server _ufsimount _qsetmount If at this time some file systems were mounted you need to cleanup linux mount points. After that QStar servers may be restarted using “/opt/QStar/install/rc start” and sets remounted. How do I know that data is communicated to Cleversafe ?mmparam clever will show changing numbers on lines: Archived since mount: Replicated since mount:
Indicates that writes are working. clever: Object (MI102611V1:86f671a1c51e97de68feecc43a11e9a90000) was read, size is 4184488 Indicates successful reads. Please note that trace log contains lot of other information not targeted for the end user. Prolonged run of the trace may slow down all operations. Nevertheless in some cases QStar service may request for such trace to analyze error situations. What files I need to send to QStar in case of error?In order to perform error analysis following information is required:
How do I perform data base backup?The data base backup is performed according to the file /opt/QStar/emg/files/clever_rc.xml. If there is a need to perform data base backup on demand the following command should be used: emgcmd backup full clever The data base backup is initiated asynchronously and it is finished when syslog contains following line: 05/28/2012 13:00:32.811275 INFO clever: Full DB backup finished: size is 112256 bytes Forced backup is recommended when IV set is moved to another computer or for any other good reasons. Directory: pub pub -> Project Scoring Template Pre-Construction Phase New Core/Branch Campus Projects pub -> Acm word Template for sig site pub -> The german unification, 1815-1870 pub -> Baltic Olympiads in Informatics: Challenges for Training Together pub -> Preparation of Papers for ieee transactions on medical imaging pub -> Forthcoming meetings and conferences pub -> Asilomar Conference on Circuits, Systems & Computers, Pacific Grove, ca, November 1978, pp. 55 58 pub -> Forthcoming meetings and conferences pub -> Harmonised compatibility and sharing conditions for video pmse in the 7 9 ghz frequency band, taking into account radar use Download 37.02 Kb. Share with your friends:
|