Home
SEPsesam Administrator Manual
Contents
1. MISC 2 3 5 Deinstallation Server Tapeserver Client GUI Client cd ID bin sesam sm_setup delete 2007 SEP AG 16 SEPsesam Version 3 0 SEP 2 3 INSTALLATION ON UNIX AND LINUX Global Storage Management 2 3 6 Set SEPsesam Environment on UNIX For the execution of SEPsesam Programs the environment variables PATH LD_LIBRARY_PATH OPENRDA INI should be set They should be set with the available profile ID var ini sesam2000 ini Procedure At the server go to the Terminal level and enter cat etc sesam2000 ini Command Under SM INI cut the Path of the IDry and with cd IV var ini Command change to the ini directory Apply the settings from sesam2000 profile with sesam2000 profile Command important is the space between the dots Example for the Profile GENERATED sesam profile sesam2000 environment variables sesam2000 opt sesam var ini sesam_db opt sesam var db OA ROOT sesam_db OPENRDA_INI opt sesam var ini openrda ini SESAM ROOT opt sesam bin sms LANG de_DE ISO8859 1 PATH PATH sesam2000 opt sesam bin sesam opt sesam bin sms opt s esam bin gui opt sesam bin db OA ROOT schema sesam sal export sesam2000 sesam_db OA ROOT OPENRDA INI SESAM ROOT LANG PATH echo sesam2000 directory sesam2000 environment for sesam database opt sesam bin db setenv2 sh sesam2000 COMPUTERNAME necessary for local client COMPUTERNAME uname n cu
2. 4 3 Backup protocol Detailed information about a Backup run e g SBC messages not saved files FTP connect messages End status etc ID var lis Taskname yyyymmdd_seqnr _ S T no t Taskname as configured in the GUI yyyymmdd Date of the Backup day seqnr sequential number rel to the Backup day S Backup type S SMS X Command event or external identifier for INFORMIX ORACLE SAP etc T Backup level for SMS F D I or C In the user interface GUI can be found under Backups by Status selected task Properties Protocol or by clicking the corresponding Backup in the calendar sheet 2007 SEP AG 64 SEPsesam Version 3 0 SEP 4 4 LIST OF THE SAVED FILES Global Storage Manogement 4 4 List of the saved files List of all saved files of a Backup task Backup journal ID var lis Taskname yyyymmdd_seqnr _ S T lis Example Contents of a LIS file home bfa lib d 22 06 2000 03 22 29 22 06 2000 03 22 29 3 528 652 home bfa lib einsaetze2 f 22 06 2000 03 22 23 22 06 2000 03 22 23 3 652 788 Used in the GUI in the Restore wizard to build the selection tree for a selective Restore 4 5 Segment files Partner file of the equally named lis File Here are stored the media and the segments on which the saveset was written ID var lis Taskname yyyymmdd_seqnr S T sgm Example SAVESET SD20000622110016 TAPEID 14 SEGMENT 3 14 0 3 500014 3555 14 116230016 4 500014 1501
3. E005 DATABAS val could not find column val within record support sep de E006 DATABAS val empty recordlist can not catch requested data gt support sep de E007 DATABAS Unexpected NULL value gt support sep de E008 DATABAS CONVERT DATE TIME wrong parameter val gt support sep de E009 DATABAS OA MAKE DB REC LIS val val gt supportOsep de E010 DATABAS OA MAKE DB REC LIS val too much columns max val gt supportOsep de E011 DATABAS val val cannot allocate memory val Bytes gt support sep de E012 DATABAS val SQL pipe doesn t return the expected characters gt supportOsep de E013 DATABAS val val error during open ing a pipe gt support sep de E014 DATABAS OA DO SQL val error from SQLcommand val gt support sep de E015 DATABAS OA _DO_SQL val error from DAMISQL val gt support sep de E016 DATABAS val PSQL doesn t create output gt supportOsep de E017 DATABAS val val columns too much gt supportOsep de E018 DATABAS val with unexpected result val gt support sep de 2007 SEP AG 101 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 7 DBFPACK Database File Packer Error message Cause Solution E001 DBFPACK Cannot find out file falschen DBF Name
4. io 68 5 5 Access restriction for Command events a a a 69 5 51 Problem description e 69 E eee EG MET O 70 O hee ee ae aa na ora abe ed 70 5 6 Configuration of a Firewall e e 71 Men ewe det eas en shave ete Ino A Tata 75 LA dee Dm BAe et EH ds oe wR Eee al 75 6 Disaster Recovery 77 Deen es A eo eee ee 78 A wee of oases betes les 80 6 2 1 Proceeding in disaster case 2 ee ee 81 7 Client System Recovery 83 epee hose a heats pee ee econ eee ee a 83 Se ee Pe Ben fos he oe hae ee ae oh Be ee eames an Siete acta as 83 8 Special modules 85 8 1 Online Backup Restore Domino Server 2 0 000000 000 eee ee eee 85 8 1 1 System requirements kh 85 9 1 2 Full Backup 6 domog Stok kon gc ea ee oe a ee a eo SO acne 86 eR Be ee ee poh alat Bad ook ook Pee ge Hoke 86 ON Saka tar ae IPH ah Hoc nek td 86 8 2 1 System requirements kh 86 8 2 2 Description MSOLI a 86 8 2 3 Full Backupl 2 87 bth aa AENA 87 8 3 Online Backup Exchange Server 5 5 2 oo 87 8 3 1 System requirements oh 87 np A tha tan aa A Tete MOO et Me aie etches a at eo 88 8 3 3 Pull Backup 23 i 4 4 bee ea ee Rae hb eb e 88 2007 SEP AG 6 SEPsesam Version 3 0 CONTENTS SEP Global Storage Manogament 8 3 4 Information Store Backup 8 3 5 Full Restore 2 2 2 ee eee 9 Problem analysis and solution 9 1 Problems with the inte
5. 3 2 2 Optional Extensions of SBC The Standard is Backup Type Path whose source is a full path specification at the Client Examples For WNT D Program Files For UNIXe usr users In case that several Backup sources are saved from the Client in a single task they should be specified delimited with commas Examples For WNT D Program Files D MSOffice For UNIXes usr users usr homes opt sesam For better readability spaces after the comma are allowed Further they are ignored License needing extensions are e Backup type Exchange Server As source of an Exchange Server Backup should be specified the identification of the Exchange database often identical with the WNT Server name Backup type INFORMIX As source of an INFORMIX Backup should be specified the identification of the INFORMIX database An INFORMIX task is started externally from the INFORMIX System with ON BAR Backup type Lotus Notes As source of a Lotus Notes Backup should be specified the identification of the Lotus Notes database Backup type MS SQL Server As source of a MS SQL Server Backup should be specified the identification of the SQL Server database Backup type ORACLE As source of an ORACLE Backup should be specified the ORACLE SID of the ORACLE database An ORACLE task is started externally from the ORACLE System with RMAN Backup type ORACLE7 As source of an ORACLE7 Backup should be specified the ORACLE SID of the ORACLE databa
6. E005 DRIVES SMS could not find label on me dia as E001 DRIVES E006 DRIVES SMS in not allowed state gt sm shutdown sm_startup E007 DRIVES The pipes of SMS aren t running please restart SMS sm_main reload sms E008 DRIVES Error from login to SMS sm_main reload sms E009 DRIVES message val gt support sep de E010 DRIVES Error from initialising the media in drive val val val as E001 DRIVES Error message Cause Solution E001 GETVOL Request for media val com pleted with error val as E001 DRIVES gt support sep de 2007 SEP AG 103 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 9 HOTSTS Problems with computers Error message Cause Solution E001 HOSTS Could not find computer val in database val gt configure again E002 HOSTS RemoteCopy val invalid mode val gt supportOsep de E003 HOSTS RemoteCopy val val val gt val error at val val gt supportOsep de gt evtl NW Check E004 HOSTS RemoteCopy val val val gt val val gt support sep de E005 HOSTS RemoteCopy error reading from val num val val gt supportOsep de gt evtl NW Check E006 HOSTS RemoteCmd val gt invalid ac cessmode val gt Change Client property Accessmode in the GUI E007 HOSTS
7. NETWORK 1135 E ERROR Remote IP address could not be resolved s CTRLD 11136 E ERROR Host s is not allowed to connect or security problem for user s INTF 1137 E ERROR Parameter to long J STREAM 11138 E ERROR Pipe creation problem s CTRLD 1139 E ERROR CTRLD reply s PROCESS 11140 E ERROR Unable to start process s PROCESS 1141 E ERROR Unable to start thread s CLI 1142 E ERROR c Mandatory argument not specified DLL 1143 E_ERROR Problem while loading dynamic link library Zs DLL 1144 E_ERROR Problem while unloading dynamic link library hs STPD 11145 E ERROR SESAM server signal received s DB 11146 E_ERROR DATABASE client error s Itemx 11147 E ERROR Unable to access item s s W2KSS 1148 E_ERROR W2KSS Error s Encryption 1149 E_ERROR Encryption password validation failed Ex2Kx 11150 E ERROR Ex2K Error s Encryption 1151 E ERROR Encryption Decryption operation failed 2007 SEP AG 30 SEPsesam Version 3 0 SEP 3 2 SESAMBACKUPCLIENT SBC Global Storage Manogament Encryption 1152 E_ERROR Writing SSET file failed Encryption 1153 E ERROR Reading SSET file failed CLI 11154 E_ERROR Invalid argument for switch c J LAST 19999 E_ERROR Unknown message code d
8. s Padding remaining Cannot write to remote archive Exiting Unable to open GEN interface s Unknown item type 4d Skipping remaining Unknown item type d Internal error eHdrFmt unknown Invalid argument s for switch c Failed STP call s s 2007 SEP AG 27 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 3 THE PROGRAMS OF SEPSESAM CLI 1040 E_ERROR CLI 1041 E_ERROR too long CLI 1042 E_ERROR screen CLI 1043 E_ERROR CLI 1044 E_ERROR REGISTRY 1045 E ERROR REGISTRY 1046 E ERROR REGISTRY 1047 E ERROR REGISTRY 1048 E ERROR REGISTRY 1049 E ERROR user profile images REGISTRY 1050 E ERROR REGISTRY 1051 E ERROR REGISTRY 1052 E ERROR s ProfileImagePath REGISTRY 1053 E_ERROR INI 1054 E_ERROR FORMAT LOGICAL BLK SIZE in s ARCHIVE 1055 E_ERROR 1056 E_ERROR ARCHIVE 411057 E_ERROR 1058 E_ERROR ARCHIVE 11059 E ERROR 1060 E_ERROR ARCHIVE 41061 E_ERROR 1062 E_ERROR 1063 E_ERROR 1064 E_ERROR FILE I0 41065 E ERROR FILE EXCLx 11066 E ERROR hs hs 3 XBSA 1067 E_ERROR s CLI 1068 E_ERROR CLI 1069 E_ERROR CLI 1070 E_ERROR CLI 1071 E_ERROR CLI 1072 E_ERROR he h CLI 1073 E_ERROR
9. 11113 E ERROR Unable to open file s for restore d MSEX 11114 E ERROR Failed to read fd bytes from remote archive MSEX 1115 E ERROR Failed to write to remote archive s s MSEX 1116 E ERROR Failed to read from remote archive s MSEX 1117 E ERROR Cannot close saveset sbc_gen sh 1118 E ERROR s not existent CLI 1119 E_ERROR SESAM server not specified sbc_gen sh 1120 E_ERROR Backup source could not be found Exiting Per 11121 E ERROR For this operation option f require F pipe Exiting KILL 11122 E ERROR Can not kill process group I dl zs Exiting sbc_gen sh 1123 E_ERROR sbc_gen sh exit with error FP 1124 E_ERROR Error while browsing through process list hs 5 KILL 1125 E_ERROR Cannot find matching process KILL 1126 E_ERROR Cannot perform core termination CTRLC 11127 E_ERROR Cannot detect currently logged user s NETWORK 11128 E_ERROR Network communication problem s NETWORK 1129 E ERROR Not connected CTRLC 1130 E ERROR STDIN channel not established s INI 11131 E ERROR Unable to open initialization file s CTRLC 1132 E ERROR STDIN channel broken s CTRLD 1133 E_ERROR Denying service Maximum active connection reached CTRLD 11134 E ERROR Cannot start child process s
10. allowed COM 1074 E_ERROR COM 1075 E_ERROR COM 1076 E_ERROR Invalid host specification for option c Invalid argument for c Encryption password Invalid usage Try sbc h for help Option c is required for this operation Invalid time specification for since backup Error while retrieving user profile images Cannot enable backup restore privilegies Cannot disable backup restore privilegies Cannot find registry data Cannot enable registry privilegies to retrieve E Error while unloading user profile images J Cannot retrieve user profiles Cannot retrieve value for Unable to open registry key s Invalid PHYSICAL_BLK_SIZE or Initialization of archive failed s Error while retrieving items Cannot create local archive s Error s Error while writing data Error s Unable to open local archive fs Error s Error while reading data Error s Error while unpacking data s Local file s does not exist Unable to open local file s Error while processing local file s Cannot create local file s Error while reading exclude pattern file XBSA Call BSAGetObject failed with message c Specified argument too long c Invalid argument must be numeric Mandatory argument not specified c Invalid time specified use hhmm Unable to open inclu
11. e 9 232 UNIX AGE cito e Soe RO Se a Ao se A Ae A Fe 8 11 dd a o dd serak a 11 2 3 4 UNIX Interface GUD oa 11 2 3 5 Deinstallation Server Tapeserver Client GUI Client 12 2 3 6 Set SEPsesam Environment on UNIX o e e 13 2 4 Installation on Windows 2 4 1 Basic procedures 2 42 Windows Backup Server 2 ee 16 2 4 3 Waridows Client eo eee ia o TP ena mane ee he aa eee 16 2 44 Windows Tape Server 0 a 16 2 4 5 Windows Interface GUD ia 16 SEP Global Storage Manogament CONTENTS 2 5 Installation o OS 2 2442244 0b seh ab ae 18 2 6 SEPsesam Client Supported operating systems 200004 18 2 7 SEPsesam Client Supported Online Modules o 19 3 The programs of SEPsesam 21 3 1 User Interface GUI Graphical User Interface 0 21 3 2 SesamBackupClient SBC 21 3 21 SBC Error codes E E a e e E O 22 3 2 2 Optional Extensions of SBC oaa ee ee 27 3 3 The Programs of the Server e 28 3 9 1 The Kernel programs esos pee ho Be oe ee ek a ee 28 9 3 ll BACK wi nd de ER Bm Hb Ok ae he ee 28 33 12 sm drive 2 0 2 aoe bE RR AE RA ee hE Ree Se 29 3 3 1 3 EMMA 29 20 LAW Sm anit 4k ee ee AN 30 0 125 Sm loader i i a a snug Bok Gone we he tow Sa A HOR a wo ea A 30 ash dip a Se idee See e ces ese wd ah ee See BI an eta 31 yee engan ey acetate nee eee eee Gee eee 32 33218 Sm
12. ing slot information from the media archive load loads a media from a magazine slot into a drive unload unloads a media from a drive into a slot if necessary the media is set offline first show shows the contents of the loader using the barcode reader if available Result in ID var work showlist_ In _ dn tmp 1 num sesam internal number of the loader d num sesam internal number of the drive for load unload show sesam internal number of the IO Port for export import s num label Slot number or media label Slot is determined using the media archive mandatory for load export and import optional for unload and show o no mount optional do not set the loaded media to MOUNT State L logfile Redirection of the logging output to a special file v num Verbose level 0 1 or 2 h Help output of the call interface Return value s GLBV gv loader stsfIn Result status o k failure GLBV gv loader msg In Value or message Example sm_loader import l 1 d 0 s 0 gt gt Imports the media in Loader 1 from 1O Port 0 to Slot 0 sm_loader unload l 1 d 2 s 5 gt gt Unloads the media in Drive 2 of Loader 1 to Slot 5 3 3 1 6 sm recover Description SEPsesam command line interface to analyse a media and restore data or listing from its savesets Reguires a media inserted into drive Missing information are entered in a dialog with user Tape changes for further tapes are reguested automatically 2007 SEP AG 35 SEPs
13. access are described below 3 4 1 Command execution at the Client CTRL Service The communication between computers is done over the SEPsesam CTRL Services an own SEP development on TCP IP Basis Using a CTRL Client sm_ctrlc the CTRL Daemon Server sm ctrid on another computer can be contacted and SEPsesam specific actions can be started The CTRLD is started on UNIX as Daemon on WINDOWS as Service in the background Using a proprietary protocol and the allowed nodes users directories and commands stored at the Client unauthorized usage can be avoided The CTRLD Program must therefore run under a Superuser Account 2007 SEP AG 53 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM The access to CTRLD is configured in the file ID var ini sm ini CTRLD_Server CTRLD_Port 11301 Max_Connections 20 Bin_Directory su bin sesam Work_Directory su bin sesam from to it only CTRLD_Path su bin sesam su bin sms programs may be started in these directories only Section name TCP IP Port of the STPD max connections Directory of sm_stpd exe Working directory files may be copied HHHH CTRLD_Logging Section name Log_Directory su var log lgc Directory for Logging files Log_Level 0 0 no Logging up to max Level 6 poss Log_Details 0 1 2 up to max Level 3 possible Log_Size 256 max logging file size CTRLD_Auth Section name Auth File su var ini
14. available on Windows NT without Active Directories it should go also in normal mode 2 Restore the SESAM REG saveset of the Registry Backup with the help of metadata from the Disaster interface 3 Boot the computer in normal mode Only in case of Windows 2000 Professional Windows 2000 Server 2003 Server XP with active directory you should boot with the F8 key in directory recovery mode 4 Restore the SESAM SYSTEM STATE saveset of the System State Backup with the help of metadata from the Disaster interface 5 Restore the remaining savesets of the Disaster interface with mode overwrite Hint In case SYSTEMROOT is not equal to SESAMROOT e g c WINNT and d Programme SEPsesam we have a restore problem Therefore please change the file lt SESAMROOT gt var ini sm ini under PATHES the value of the variable gv rw_tmp c temp To avoid that you should install SEPsesam client preferrably there where your system resides 2007 SEP AG 85 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 6 DISASTER RECOVERY 2007 SEP AG 86 SEPsesam Version 3 0 Chapter 7 Client System Recovery 71 System Recovery for UNIX LINUX Clients In order to be ready for system disk failures at UNIX LINUX Clients the corresponding system directories must be Backed up In case of system disk failure after a new disk is built in and the operating system is installed this data is copied back again with a Restore
15. if desired copy that information in a procedure file e g sm_disas sh cmd e Insert the media in the drive and execute the Restore command or start sm_disas sh cmd Example The meta data of the Disaster interface looks as follows SESAM 00003 d Programme SEPsesam SC200207 10200512 sbc r l full o over S softnt6 11001 d SMS Tape0 t SESAM 00003 3 s SC20020710200512 n 5 R SESAM_00003 is the media d Programme SEPsesam is the source path SC20020710200512 is the saveset on the media sbc r is the Restore command 6 1 Disaster Recovery without meta data If the meta data of the Disaster interface is not available then you have to search for the meta data To get this meta data or to restore directly a saveset from tape SEPsesam supplies the program sm recover see 3 3 1 6 The following output shows a sample of a sm_recover session florix opt sesam var ini sm_recover num device name typ 1 disk1 DISK HARD 2 dev nst0 TZ88 Enter drive number r to repeat list q to quit 2 Analyse a media restore data or listings of savesets Restoring data while SEPsesam is active may cause conflicts due to concurrently running activities on the drive If you re shure that there are no activities scheduled during recover you don t neeed to block SEPsesam Blocking SEPsesam during recover prevents execution of activities scheduled for the other drives too Do you want to block SEPsesam yln
16. 00 52 Tue softnt6 O DISASTERN 0 D 4 2002 11 12 20 05 37 successful O DISASTERN 1 D 4 2002 11 12 20 09 49 successful O NT6 _E1 D 4 2002 11 12 23 41 38 successful O NT6 _E3 D 4 2002 11 12 23 41 38 successful O NT6 _E2 D 4 2002 11 12 23 41 39 successful 63 without without without without without warnings warnings warnings warnings warnings SEP Global Storage Management CHAPTER 4 PROTOCOLS AND LISTINGS 4 2 Daily protocol Chronological report about the activities of a SEPsesam Backup day in the file ID var prot yyyymmdd prt In the user interface GUI can be found under Protocols Daily protocol The following information is written in the protocol PID Process Identifier Identification unambiguous identification of the message with Severity Number Modulename Severity I Information Severity W Warning Severity E Error Example Timestamp Identification PID Text 2002 11 12 08 00 52 1001 STARTAL 1300 Date identification 20021112 2002 11 12 08 00 54 1002 START 4131 the terminated BACKUP tasks 2002 11 12 08 00 55 1002 START 4153 the terminated BACKUP tasks 2002 11 12 08 00 55 1002 STARTAL 1300 START ALL finished 2002 11 12 08 00 58 1001 START 4153 START on drive 5 finished 2002 11 12 08 00 59 1001 START 4131 START on drive 4 finished 2002 11 12 08 05 06 1I007 SEPULER 4467 start event sepuler event c 2002 11 12 08 05 08 1003 MEDIA 2350 INIT Initialization of a Me
17. 24 Date 3 4 2001 3 4 2001 3 4 2001 status running Priority status running 1 Allocate ORACLE 1 ORACLE allocated DIFF DIFF 2007 SEP AG AT SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM 31 bfasco exl 12 30 3 4 2001 1 DIFF executing gueue Resource 2 status running allocated FULL 4 bfasco 2 10 24 3 4 2001 1 FULL 2 17 bfaaix 2 12 30 3 4 2001 1 FULL 3 executing gueue Resource 3 status blocked allocated executing gueue Resource 4 status running allocated INCR 29 bfasinix 2 10 24 3 4 2001 1 INCR 2 executing gueue Resource 5 status running allocated RESTORE hard 3 3 3 11 Jobs without media pool assignment A Backup task must always have a media pool assigned Other jobs without media pool which want to allocate exclusively a drive generate an unambiguous value and allocate the drive with it So is guaranteed that e g during a media introduction or Restore the drive is exclusively allocated Non Backup Restore resp Media init Jobs as e g smistart for a drive are processed in the queue gu all 3 3 3 12 Logging of the Queue Manager programs The Logging of the Queue Manager programs is set in ID var ini debug ini see 4 6 1 SM_QM 0 SM_QM_MAIN 1 Then appears ID var log lgc sm_qm lgc ID var log 1gc sm gm main Igc 3 3 4 The Database SEPsesam keeps its internal configuration and run time data in a database The corr
18. Log resp Trace main directory ID var tmp Short term temporary files ID var work Medium term temporary files etc sesam2000 ini resp links to the paths of the most important ini Files HKEY LOCAL MACHINE SOFTWARE SEP Elek tronik GmbH sesam var ini contains the following initialization files debug ini Logging configuration sesam kernel openrda ini sesam db open Access sm ini sesam configuration Paths etc sms ini SMS Server configuration Paths etc stpd ini STPD Server configuration Paths etc After the installation the access to directories ID skel and ID bin can be set to Read Only 11 SEP Global Storage Manogament CHAPTER 2 INSTALLATION 2 2 sm setup Description Program for component installation resp deinstallation Except that it offers the possibility to create or modify files modify and read the Windows Registry and an accumulative copy function Command reference The seguence of parameters must be observed The Installation directory for the variable data under ID var can be changed with the optional Argument var vardir The following calls must be executed in ID bin sesam Installation of a Server sm_setup make srv var wardir Hint At a server installation a client and a tape server are created as well Installation of a Tape Server sm_setup make node SesamServer var vardir Installation of a graphical interface sm setup make gui s
19. OF SEPSESAM These processes are controlled with sm mainf exeh sm main install Set up the SEPsesam Services on Windows only sm main remove Remove the SEPsesam Services on Windows only sm main start Start the SEPsesam Server sm main stop Stop the SEPsesam Server sm main restart Restart the SEPsesam Server sm main reload main node sepuler db qm rmi sms stpd passd ctr1 Start again a specific process sm main status Status reguest for the SEPsesam Server processes Data Stream of backup files backup data The picture shows the cooperation of the particular functional units which are presented here in component view i e they can be eventually combined on a single computer So the SEPsesam Server contains the Server and Tape server components a pure Backup Client the Client component only etc The dataflow can be also distributed in any way between the source computers and the Tape servers whereby the highest level of control always belongs to SEPsesam 2007 SEP AG 56 SEPsesam Version 3 0 SEP 3 6 GLOBAL VARIABLES GLBV Global Storage Manogement SEPsesam Server Sesam Clients CR r gt Loader 1 Drive1 2 3 Sesam Clients Loader 2 The above example shows a SEPsesam Server with a local Loader 1 which serves 3 local drives 1 2 3 Further there is a computer T1 with loader of the same type as well as T2 with a single drive and several Clients On T1 and T2 is
20. RemoteCmd val gt error val gt supportOsep de gt evtl NW Check E008 HOSTS Configuration of a val backup client completed with errors val gt supportOsep de gt evtl NW Check gt then repeat E009 HOSTS WNT computer val was NOT configured gt NW Check gt repeat E010 HOSTS Error cannot open local file val to insert SESAM server computer gt Check existence 2007 SEP AG 104 SEPsesam Version 3 0 9 2 ERROR MESSAGES OF THE KERNEL SOFTWARE SEP Global Storage Manogament 9 2 10 LOADERS Problems with loaders Error message Cause Solution E001 LOADERS Action val of loader val failed gt Problems at the loader gt Check cables gt sm_slu scan Check SCSLaccess gt evtl switch off for a short time E003 LOADERS The specified destination slot val of loader val is occupied Unload to already occupied Slot gt Check and fix if necessary the slotinfo in the archive gt Archive adjustment in case of manual changes in the loader E004 LOADERS Attention Loader val is auto unloading Auto unload will now be ac tivated aktiviert no action necessary E005 LOADERS Attention Intern drive num ber of drive val val not found in loader val Please check your drive configura tion val gt Check and fix if necessary the loader con figuration 9 2 11 MEDIA Problems with
21. Transport Port and their filling with media labels as well Example sm slu 360 l full I label further parameters as before Slot O adr 0 src 1030 tape 1 S00001 Slot 2 adr 2 src 4 tape 1 S00100 Slot 8 adr 8 src 1030 tape 1 S00004 Slot 9 adr 9 src 0 tape 1 800005 Slot 10 adr 10 src 1031 tape 1 500101 Drive 0 adr 1030 src 1 tape 1 S00003 3 7 6 sm_slu move media With this option media can be moved As target and source a loader element Slot Drive Port can be selected This function can change the filling measured by SEPsesam and therefore should be only used with respect to the media archive comp 3 3 1 5 The unload of drives requires eventually a previous Unload command for the corresponding drive 3 7 7 sm_slu unload for tapes With this option drives can be unloaded The media is rewound and ejected Available drive doors are opened the drive is then set to the offline state This option should not be confused with the Unload of sm loader see 3 3 1 5 3 7 8 sm_slu load With this option offline media in the drive can be set online again 3 7 9 sm slu rewind With this option media in the drive can be rewound 3 7 10 sm slu allow removal With this option a drive locked with prevent removal can be released again 3 7 11 sm_slu prevent removal With this option drives can be locked The unload of media in the drive with the control elem
22. a change in the file ID var ini sm ini SM_DBF_PACK Section for sm_dbf_pack AUTOSTART YES YES gt execute sm_dbf_pack at NEWDAY 3 3 5 Sesam Multi Stream SMS For the recording of Backup data a special Multi Stream Processing is used This processing makes possible the simultaneous transfer of Backup data from several Backup clients to a single media With this processing the drives can be used at corresponding higher data rates in the so called streaming mode The recording of data goes on with maximal recording speed there are no stop and repositioning times the network load as well as the transfer times are reduced to a minimum 29 Additionally at the beginning of a Backup and further in the process special marks file marks are written on the tape which makes possible the extremely fast positioning to the Backup data in case of a Restore This is especially important for the Restore of single files With the implemented processing the tape is positioned directly to the last mark before the begin of the necessary data and the corresponding data is transferred over the stpd to the Backup client 2007 SEP AG 49 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM The implemented processing allows the recording of Backup data over tape boundaries so that the Backup of any data quantities is possible see 3 3 1 10 In ID var ini sms ini are specified the execution parame
23. a job with entry number in queue optional allocate resource default unknown preferred resource job_sho queue job count shows entry and status of count job del_entry entry_number deletes the given job shutdown shutdown of sm_qm_main delete queues amp jobs 3 3 3 1 Queue Manager Concept In SEPsesam each Backup is assigned to a media pool A media pool is always unambiguously assigned to a drive group Normally several different media pools are assigned to the same drive group e g a drive group for FULL DIFF INCR Weekend Working days or ORACLE File_system For the processing of a Backup task without drive specification a suitable drive from the drive group must be selected If no drive contains media from the desired media pool then a strategy for bringing a media must be processed According to the concept the media from a media pool can be dynamically on demand requested 3 3 3 2 Queue per drive group The Backup tasks are then positioned in drive group Queues according to the assignment media pool to drive group The drive group Queue has a holding resp pending Queue and for each drive an executing Queue Each job and the executing Queue have the attribute allocate With this attribute an allocation generally a media pool is assigned to a job The attribute of the job is assigned to the executing queue when a job is started in this queue A job can be started in an executing Queue only in cas
24. be set for execution with a Start time submit The Queue Manager then takes care that a Job is activated at its Start time executing whereby always only as many Jobs can be executing as specified in the joblimit of the queue Jobs whose start time is still not reached are holding whose start time is reached but still may not run because of the joblimit are pending In SEPsesam the Queue manager is used for distribution of Backups Restores Initializa tions etc upon the available drives For each drive group a queue with the same name is created which owns an executing queue for each drive This allows a specific access to the system resources according to the parallel processing level assigned to each resource joblimit If a drive is configured for maximum 4 simultaneous Backups the corresponding level of parallel processing is exactly forced through restriction of the assigned queue to maximum 4 tasks joblimit The cooperation between SEPuler and Queue manager happens in a way that the user specifies in the SEPuler events for Backups Restores Initializations etc and these are transferred to the Queue Manager according to the resource used when the start time is reached The Queue manager then determines according to the load of the resource when the action will be actually executed There can be scheduled e g in the event calendar 100 Backups on a specific drive at the same time They are transferred to the Queue manager
25. connect accept resolve java net SocketPermission 127 0 0 1 4 connect accept resolve permission java net SocketPermission softnt6 connect accept resolve ETC permission permission permission permission read permission permission java util java util java util java util java util java lang PropertyPermission user dir read PropertyPermission user name read PropertyPermission file encoding read PropertyPermission java rmi server hostname PropertyPermission read write RuntimePermission accessClassInPackage sun jdbc odbc permission permission permission permission permission FILE permission permission permission java lang RuntimePermission loadLibrary JdbcOdbc de sep sesam gui server RestorePermission de sep sesam gui server OperatorPermission java lang RuntimePermission loadLibrary ICE_JNIRegistry java sql SQLPermission setLog java io FilePermission D sesam var read write java io FilePermission JdbcOdbcSecurityCheck write java io FilePermission lt lt ALL FILES gt gt execute 2007 SEP AG 21 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 2 INSTALLATION Hint In ID Nbin gui you will find the link sesam gui This link can be dragged with the mouse to the Windows Desktop or and to the Taskbar or and to the Startbutton With a double
26. gt y wait until SEPuler the timecontrol of SEPsesam finishes its current work SEPuler now is blocked Do you wish to enter label saveset name and segment number directly no search 2007 SEP AG 82 SEPsesam Version 3 0 SEP 6 1 DISASTER RECOVERY WITHOUT META DATA Global Storage Management ing on media y n gt n now tape will be rewinded and scanned until end Header STATUS SUCCESS MSG Tapelabel WEEKOOOO2 TapeID 2 000000 Tapeinfo SESAM volume BlockSiz e 65536 Creation Date 2004 02 19 12 27 57 Segments 1 SavesetName SC20040219122608 SavesetInfo job SESAM BACKUP UNIX 2 SavesetName SC20040219122622 SavesetInfo job ntpc23 all UNIX 3 SavesetName SC20040219122611 SavesetInfo job softnt15 all WNT 4 MSG 1043 Invalid tape format Saveset Header should follow TapeMark 5 MSG 1043 Invalid tape format Saveset Header should follow TapeMark 6 SavesetName SC20040219122611 SavesetInfo job softnt15 all WNT 7 MSG 1027 Skipping tapemarks on tape failed Trailer STATUS SUCCESS Tape Label WEEKOOOO2 Next Tape Label Tape Id 2 000000 Tape BlockSize 65536 Tape Info Creation Date 2004 02 20 10 00 19 Tape EOM Flag FALSE MSG OK now media was scanned there are 4 savesets on the media IOO1 RECOVER General tape data I002 RECOVER Label WEEKO0002 I003 RECOVER Creation date 2004 02 19 12 27 57 1004 RECOVER Header info SESAM volume I005
27. installed the TapeServer component on C1 the Client component In the configuration we have then T1 T2 and Cl as Clients 2 loaders and 7 drives Through the configuration of Backup tasks the following dataflows can be created Client Target drive Data flow C1 D1 from C1 to Drivel at Server C1 D5 from C1 to Drive5 at T1 without loop over the Server T1 D4 from T1 to Drive4 at T1 without loop over the Server T1 D3 from T1 to Drive3 at Server The supplement data Listings Segment files etc are transferred from the TapeServer to the SEPsesam Server 3 6 Global Variables GLBV For communication between programs special global values the so called GLBV global variables are created by the SEPsesam Server These values reside on WNT Systems in the WNT Registry and on UNIX Systems in special files in directory ID var glbv Attention The setting resp deletion of GLBVs can lead to severe system problems and may be therefore used by System Specialists only 2007 SEP AG 57 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM With the program ID bin sesam sm_glbv the GLBVs can be set read and deleted The syntax is available with the call sm_glbv h 3 7 Sesam Loader Utility SLU With sm slu can be controlled SCSI II loaders under Windows NT Windows 2000 DECUNIX HPUNIX and LINUX When sm slu is called without arguments it outputs
28. media Error message Cause Solution E001 MEDIA val error val gt support sep de E002 MEDIA Error from submitting val into queue val Queuemanager is not running gt sm shutdown sm startup E003 MEDIA Error when loading media from slot val Error from EXXX LOADERS E004 MEDIA Adminstration of media archive doesn t return a status gt supportOsep de E005 MEDIA Archive action val finished with error val gt supportOsep de E006 MEDIA Archive action val finished with error unknown EXIT code val val gt support sep de 2007 SEP AG 105 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 12 RESTORE Restore problems Error message Cause Solution E001 RESTORE LIS_DB gt val Ssupport sep de E002 RESTORE Restore task val not yet de gt support sep de fined please do it now E003 RESTORE Restore val completed with gt support sep de errors val E004 RESTORE Selektive generations restore gt support sep de didn t find savesets E005 RESTORE Selective generations restore gt support sep de cannot allocate memory val nicht belegen val E006 RESTORE SEARCH LIS val is an in gt support sep de valid name of task 2007 SEP AG 106 SEPsesam Version 3 0 9 2 ERROR MESSAGES OF THE KERNEL SO
29. option val line val gt sm_backup h Follow the usage E008 BACKUP SBC version at client side does not support encryption val old SBC Version on the Client gt Contact support sep de discuss and install the right version 92007 SEP AG 98 SEPsesam Version 3 0 9 2 ERROR MESSAGES OF THE KERNEL SOFTWARE SEP Global Storage Management 9 2 2 BASICS Error message Cause Solution E001 BASICS STR_CHAIN string overflow gt support sep de E002 BASICS val error opening file val mode val insufficient disk space gt extend missing directory gt Create directory gt supportOsep de E003 BASICS val val not yet existing please restart SESAM sm startup E004 BASICS GET_LOCAL_TCPIP_ADRESS could not find a usable WinSock DLL gt supportOsep de E005 BASICS HAL REDIR string overflow val val gt support sep de E006 BASICS CHECK SMS autom restart failed SMS not running SMS gt sm_shutdown sm startup if necessary retry after a few minutes or reboot the computer E007 BASICS val error deleting file s val gt supportOsep de E008 BASICS Error in command execution NW Problem val val gt NW Check Authorization not configured gt see 3 4 E009 BASICS Error copying file val val Check if the file system is full val gt support sep de E010 BASICS FIL
30. sbc in the following format For a Client with firewall restriction clients stpd_options first_port last_port Default NULL For a Tape Server with special STPD port clients stpd port stpd_port Default NULL 11001 The specifications are optional The value in these fields is used for the sbc call Example about STPD Client FireWall Tape Server STPD_MAIN listening on Port stpd_port SBC 2007 SEP AG 77 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 5 ADMINISTRATION Source Port first free Port from first_port last_port Default unrestricted Target Port stpd_port sbc XBSA selects a local port from Range and connects to STPD MAIN 4istpd port sbc connects to the next free port in Range and proposes it to STPD listening SBC XBSA STPD connects from any Source Port l to the proposed Target Port active FTP Further communication over target Port stpd port FTP Control Port source Port from Range FTP Data Port It is a convention that sbc uses 2 subsequent ports only From this follows If the first port is busy then a further attempt is made with the over next port Specification per Option S S tape server stpd port first port last port Firewall configuration SESAM Server to Client Sesam Server in the local network Access to the Client incoming calls Do not allow incoming connections outgoing calls 1 Case si
31. sm ctrld auth File containing the authorized users Entries in the authorization file sm ctrld auth softnt6 sep de root system SYSTEM Computer name User list qswnt2000 sep de root system SYSTEM Computer name User list sm_ctrle Using the function gethostbyname sm ctrlc attempts to resolve the specified Hostname If this hostname does not exist 1 is returned In case of success a connection is created to this hostname The Port is used as an INET Port and the command is used as a command for execution at the Remote Host The connection is created over a socket in the Internet Domain of type SOCK STREAM TCP connection The caller gives its STDOUT to the remote command as STDIN This command creates output on STDOUT and STDERR In case firewalls are used between the SEPsesam Server and the Client the port usage can be restricted with special options s o port see 5 6 Syntax sm ctrlc p port 1 user s o port first last host command Input parameters host Hostname of the Client command Command to be executed at the Client 2007 SEP AG 54 SEPsesam Version 3 0 SEP 3 5 PROCESSES AND DATAFLOW Global Storage Management optional Input parameters p port Listening Port of the remote CTRLD 1 user Remote User see sm_ctrld auth o port first last Port Range for Firewall usage s Communication over single Port only i e over Listening Port Exampl
32. supportOsep de 2007 SEP AG 108 SEPsesam Version 3 0
33. the SCSI Device ID should be configured for the corresponding drive Example UNIX 2007 SEP AG 58 SEPsesam Version 3 0 SEP 3 7 SESAM LOADER UTILITY SLU Global Storage Manogement STK Loader with 2 Drives 3 SCSI Devices bash 2 02 sm_slu scan ID 310 Tape GUANTUM DLT4000 2255 dev nrmt0h ID 340 Tape Quantum DLT4000 CF5F dev nrmt th ID 360 Loader STK 9730 1205 In the brackets appears the device name which must be entered in the SEPsesam drive configu ration sm_slu 360 e scsi shows then the drive numbering within the loader ID 340 Tape Drive O in Loader 360 ID 310 Tape Drive 1 in Loader 360 Example Windows TLZ9 Loader with 1 Drive 1 SCSI Device bash 2 02 sm slu scan ID 0000 other WDC AC22000L 32 4 HardDisk ID 0010 other FUJITSU MPC3084AT 6021 HardDisk ID 1000 other LITEON DVD ROM LTD163D GHR3 CdRom ID 2050 Tape DEC TLZ9 C DECAO35 Tape0 ID 2051 Loader DEC TLZ9 C DECAO35 Loader The device name for ID 2050 is Tape0 can be found in the Registry the combination of Tape0 and Loader can be seen from the identity of SCSI ID Bus and LUN 205 i e the drive and the robot unit are controlled over the same SCSl channel 3 7 2 sm_slu inquiry With the option i the producer and type of the device can be inquired This command can be also used to check if the device is properly connected and working Example sm slu 360 i ID 360 Loader STK 9730 3 7 3 sm_
34. the license check blocks the execution of Backups Restores from already performed Backups are however always possible In case TIMEOUT lt 30 days it is checked independently of SERVER amp TCPIP Demo license In case TIMEOUT gt 30 days then also SERVER amp TCPIP are checked Upon inconsistencies through evtl renaming of the computer or changed TCPIP Address the TIMEOUT is reduced to 7 days to allow the user to contact his responsible Distributor resp SEP AG support sep de in an acceptable period of time Manipulation in the license file has the effect that the TIMEOUT is set to 0 i e the sys tem is immediately locked The license check begins 10 days before the end of the licensing with the sending of warn ings over the SESAM Alarm interface in the daily protocol and to the GUI Upon licensing problems please immediately contact support sep de further information can be found under www sep de 2007 SEP AG 79 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 5 ADMINISTRATION 2007 SEP AG 80 SEPsesam Version 3 0 Chapter 6 Disaster Recovery As disaster is considered here the destruction of the SEPsesam Server itself and its data To prepare for this case we have in SEPsesam the so called Disaster Interface The control concept is the following e The Backup server backs up its own data with normal standard Backups e the meta data for these Backups is copied to other systems so t
35. version of JRE will be used for the installation of SEPsesam 4 Installation of Server Tapeserver Client under Linux Unix with the help of sm setup cd CDROM Path Folder with operating system sm setup Upon problems with the installation the delivered unzip tool should be taken from folder utils and made available to sm setup Extend the path variable or put in the same folder Then the instructions of sm setup should be followed Finally the user interface is started with TV bin gui sesam_gui sh Hints e We must be sure before the start of the SEPsesam User Interface GUI that we use the right JRE e The SEPsesam Server state can be checked in ID bin sesam with sm main status and in case of non activity the SEPsesam Server is initiated with sm startup e Stop the SEPsesam Server with IV bin sesam sm shutdown Stop the SEPsesam Tapeserver with ID bin sesam sm main stop Stop the SEPsesam client with ID bin sesam sm main stop 2007 SEP AG 14 SEPsesam Version 3 0 SEP 2 3 INSTALLATION ON UNIX AND LINUX Global Storage Management 2 3 2 UNIX Client The server must be able to resolve the client and vice versa This can be checked with ping nslookup and sm ctrlc If these commands show errors they should be fixed prior to the connection of the computer to the SEPsesam Server The functionality of SEPsesam Software is basically dependent on a correct network installation Installation w
36. x86_64 ppc e Solaris 8 9 10 e FreeBSD ab 5 x e Tru64 ab 4 0x Shared loaders Tape drives All loaders with SCSl interface and all DAT LTO AIT SUPER DLT and DLT drives are supported 2 3 1 2 Installation 1 Login under user root 2 Prepare for reading the CD ROM drive from the operating system of the server 3 The SUN JRE is necessary because it contains a JOBC ODBC Bridge which is used by the SEPsesam GUI RMI Server If there is no SUN JRE pre installed as Standard Java it can be also loaded from the SEPsesam CD subdirectory utils in the corresponding directory with the operating system used The files residing there whose names contain jre are either Shell Scripts sh executables or RPM Packages rpm Shell Scripts are executed with sh x jre sh 2007 SEP AG 13 SEPsesam Version 3 0 SEP Global Storage Manogement CHAPTER 2 INSTALLATION Executables can be directly executed from the command line RPM Packages are started with rpm ivh rpm Attention The location where JRE was installed is to be determined If there is no other active Java installation in the system it can be recommended to make that globally available in the system using a link Example The just installed java can be defined with In sf usr lib java2 jre bin java usr bin java as Standard Java Interpreter or the PATH variable can be set prior to the installation so that this
37. 093 E_ERROR Cannot end MS Exchange backup s MEM 1094 E_ERROR Unable to allocate memory MSEX 1095 E_ERROR Failed to read MS Exchange database file s MSEXx 11096 E_ERROR Failed to purge MS Exchange database log files s MSEX 1097 E_ERROR Cannot retrieve a file list from MS Exchange server fs MSEX 1098 E ERROR Cannot save file s MSEX 11100 E_ERROR Unable to open file s s1 MSEX 1101 E_ERROR Restore operation failed MSEX 11102 E_ERROR Cannot end MS Exchange restore s MSEX 11103 E ERROR Cannot get local database files paths s MSEX 11104 E ERROR Error reading file header from archive MSEX 11105 E_ERROR Cannot register MS Exchange restore s MSEX 11106 E_ERROR Cannot find MS Exchange target for file s MSEX 1107 E ERROR Cannot read file header from remote saveset MSEX 11108 E_ERROR Invalid file header magic number s MSEX 1109 E_ERROR Invalid file size in header MSEX 1110 E_ERROR Invalid file name size in header MSEX 1111 E_ERROR Cannot read file name from remote saveset MSEX 1112 E_ERROR Unable to open file s Make sure the store service has been stopped before restoring 2007 SEP AG 29 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM MSEX
38. 4 6 Analysis protocols Logging For analysis and protocol purposes all SEPsesam programs have an integrated Logging Mechanism i e the programs protocol their work in files under ID var log The scope of these loggings can be specified by the user 4 6 1 Logging of the Kernel programs The scope of logging files can be specified by the user in the file ID var ini debug ini In this file is therefore set the program name in capital letters and the logging level e g SM RESTORE 1 The meaning of logging level is the following 0 Do not create logging file 1 Standard arguments subroutine calls important variables 2 Detail additional output for problem analysis With the entry under 2007 SEP AG 65 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 4 PROTOCOLS AND LISTINGS VERBOSE STDERR 0 is the logging for STDERR 1 additionally also written to stderr This can be helpful for command line calls The files are stored under ID var log lgc lgc and upon day change renamed to _ Date lgx They have the following format 8 05 24 Logging enabled for module SM_SEPUL_EVENT PID 1171 parent proc 8 05 24 ARGUMENTS Id sm_sepul_event c v 1 114 2002 10 24 10 03 09 P 8 05 24 ARGUMENTS 8 05 24 MAIN 8 05 24 CHECK_PERMIT at 2002 11 10 08 05 24 8 05 24 Check if sepuler is passing a term with deleted event des 8 05 24 CHECK_HIGHER_PRIO 1
39. Attention should be paid that a full Restore makes sense only in case that the hardware was not changed Otherwise the corresponding device and or driver files must be filtered out in a selective Restore or further processed after the full Restore 7 2 System Recovery for Windows Clients In order to be ready for system disk failures at Windows Clients the corresponding system directo ries Registry and System state Win2000 must be Backed up In case of system disk failure after a new disk is built in and the operating system is installed this data is copied back again with a Restore 1 Install the operating system at the Client 2 Install SEPsesam at the Client 3 Boot the Windows 2000 2003 XP computer in Recovery mode therefore press the F8 key Not available on Windows NT without Active Directories it should also go in normal mode The SEPsesam Server must be reachable with ping and resolvable by nslookup 4 Restore the Registry data over GUI with mode overwrite 5 Boot the computer in Normal mode Only in case of Windows 2000 Professional Windows 2000 Server 2003 Server XP with Active Directory you should boot with the F8 key in directory recovery mode 6 Restore the System State data over GUI with mode overwrite 87 SEP Global Storage Management CHAPTER 7 CLIENT SYSTEM RECOVERY 7 Restore the remaining necessary savesets of the Client Mode up to the wish of the user Hint In case that SYSTEMROOT
40. CTRLD MAIN 4ctrld port SM CTRLC proposes the range for the further communication Within the specified range CTRLD listening on the first free Port stderr CTRLD listening on the second free Port stdin CTRLD listening on the third free Port stdout is transferred from CTRLD_MAIN to SM_CTRLC SM_CTRLC selects further 3 Ports and connects to the Ports of CTRLD at the Client The further communication is done over these 3 Ports Example about CTRLD With Single Port Range s appears the following sequence SESAM Server Firewall Client CTRLD_MAIN listening on Port ctrld_port SM CTRLC Source Port random first free Port 2007 SEP AG 76 SEPsesam Version 3 0 SEP 5 6 CONFIGURATION OF A FIREWALL Global Storage Management Source Port for CTRLD Client over ctrld_port single port Target Port ctrld_port SM_CTRLC selects a local Port and connects to CTRLD_MAIN ctrld_port SM_CTRLC proposes a single port for the further communication CTRLD listening on ctrld_port stderr stdin and stdout is transferred from CTRLD_MAIN to SM_CTRLC Further communication over this port Specification of Source Port s single port communication o port first_port last_port Specification of Target Port p ctrld_port Fields clients stpd_options and clients stpd_port There are stored first the destination port of the STPD Server and second the source ports of
41. E copy val val could not open source for read gt support sep de E011 BASICS FILE copy val val could not open target to write gt support sep de E012 BASICS FILE copy val val copy invalid status val gt supportOsep de E014 BASICS Could not submit job val into queue val Queuemanager is not running gt sm shutdown sm_startup E013 BASICS Failure in input from to val gt Usage val E015 BASICS Missing parameters more infor gt Usage mation with 2007 SEP AG 99 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 3 BREAK unexpected break Error message Cause Solution E001 BREAK Couldn t block queue val Queuemanager is not running gt sm_shutdown sm startup gt supportOsep de E002 BREAK Couldn t start queue val as E001 BREAK E003 BREAK Aborting by val at val failed val gt supportOsep de E005 BREAK Wrong input value val gt sm break h Usage E004 BREAK Missing parameters sm break h try gt sm break Usage 9 24 CONFDRI Configuration drives Error message Cause Solution E001 CONFDRI Submit val into queue val failed Configuration drives Queuemanager is not running gt sm shutdown sm startup E002 CONFDRI Error during activating the SesamMulti
42. E014 SBC_COM INQUIRE_INFO wrong type gt Usage sm_sbc_com h E015 SBC_COM INQUIRE_INFO save set val doesn t exist gt Use evtl other Saveset of the same task E016 SBC_COM INQUIRE_INFO cannot open listing file val of save set val to read Check syntax for errors E017 SBC_COM sm_sbc_com_ext During submit gt supportOsep de E018 SBC_COM Failure updating database ta ble gt supportOsep de E019 SBC COM CONNECT BACKUP loading media val into drive val failed val Error from Exxx LOADERS E020 SBC COM LOTUS_SAVESET there s no save set containing file val Use evtl other Saveset E021 SBC_COM Failure in file copy val val gt supportOsep de E022 SBC COM Medium val currently is not available is used somewhere gt wait until free terminate the other action 2007 SEP AG 107 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 14 SEPULER Messages of the SEP sesam Scheduler Error message Cause Solution E001 SEPULER Error from initialization of queue val type val gt Queuemanager is not running gt sm shutdown sm startup E002 SEPULER Error from submitting backup val into queue val type val gt as E001 SEPULER Error from initialization of queue val type val E003 SEPULER Duplication of primary key in DB resul
43. FTWARE SEP Global Storage Management 9 2 13 SBC COM Messages of the Sesam Backup Client Error message Cause Solution E000 SBC_COM Wrong parameter gt Usage sm_sbc_com h E001 SBC COM Wrong number of parameters gt Usage sm_sbc_com h E002 SBC COM Missing or wrong mandatory task gt Task name must be specified E003 SBC COM Failure selecting from database table gt supportOsep de E004 SBC_COM Missing mandatory label me dia pool or drive number gt Correct the mandatory input E005 SBC_COM FIND DRIVES OF POOL no drives for pool val configuredkonfiguriert gt Complete the media pool in the GUI E006 SBC_COM A session val was not con nected before gt first open external session E007 SBC_COM Missing mandatory save set identifier gt Correct the mandatory input E008 SBC COM GET SEGM AND OFFSETS could not find selected file val in save set val Saveset val nicht finden gt Correct the filename E009 SBC COM GET SEGM AND OFFSETS wrong format in line val gt supportOsep de E011 SBC_COM Wrong parameter s val we need savesetname starting time as returned from Open Restorewie von OpenRestore zuriick gegeben benutzen gt Use savesetname starting time as returned from OpenRestore E013 SBC_COM Restore not possible backup val was not successfulwar bes Use evtl other Saveset of the same task
44. LUTION Error description Cause Solution GUI Server not reachable Network connection to SEPsesam broken gt is the computer running GUI Server process is not running gt sm_main reload rmi Connection to database failed DB or RMI Server are not running gt sm_main reload db gt sm_main reload rmi GUI cannot start Problem with Java Rights entry for the computer in sm_java policy miss ing Example NET permission java net SocketPermission mypc name connect accept resolve Problem upon writing reading to Entry for the working directory in the working directory sm_java policy missing Example Windows FILE permission java io FilePermission D sesam var read write Example Linux Unix Tru64 FILE permission java io FilePermission sesam var read write No Online guide appears No Adobe Acrobat Reader installed gt free Download under www adobe de Reader not configured in the GUI gt GUI Configuration pre assignments Online No Online Help appears no Browser installed gt please install Browser not configured in the GUI gt GUI Configuration pre assignments Online Tips e The access rights for missing computers can be entered in the server side java policy file with the program sm setup allow_gui rechner user After changes in the sm java policy the GUI Server must
45. M Disko 50 1 8 05 24 FILL SCT MEDIA TERM descript Disko 501 8 05 24 Mediapool Disko optional Drive number 5 8 05 24 i_GET_DRIVE_GROUP for media pool Disko_ 8 05 24 select grp_name from drive_groups media_pools 8 05 24 DB_ACCESS id get_drive_group SQL select g 8 05 24 DB_ACCESS returns 1 msg 1 8 05 24 i_GET_DRIVE_GROUP LocalDisk 1 rows 8 05 24 FILL_SCT_MEDIA_TERM drvgrp LocalDisk grpflg 0 dn 8 05 24 get starting time of surrounding NEWDAYs 8 05 24 DB_ACCESS id CHECK_HIGHER_PRIO SQL select start f 8 05 24 DB_ACCESS returns 1 msg 37 With and indent is marked the entry in a subroutine with the exit from it 4 6 2 sm_db_main Logging The Logging settings can be changed for Windows in systemroot openrda ini for UNIX in OPENRDA_INI The logging here is also named Tracing CLIENT Tracefile Path and name of the trace file Default work oaclient log TRACECLIENT ALL Default FATAL SNO ERRORS see list Tracing Options SERVER Tracefile Path and name of the trace file Default work sm_db_main log TraceOptions Default all f see list Tracing Parameters and Options 2007 SEP AG 66 SEPsesam Version 3 0 SEP 4 6 ANALYSIS PROTOCOLS LOGGING Global Storage Management OLEDB ODBC32 Tracefile Path and name of the trace file TraceOptions 0 2 0 FATAL ERROR SNO 1 Function level tracing 2 most detailed tracing level Se
46. P Global Storage Manegament CHAPTER 2 INSTALLATION Database resp application on operating system Informix 7 xx 9 2000 Lotus Notes MS Exchange 2000 or 5 5 MS SQL Server Oracle 7 8 xx and 9i SAP R 3 with Oracle Datenbank SAP R 3 with SAP DB Datenbank LINUX SuSE Red Hat Debian further upon re quest UNIX SUN HPUX TRU64 AIX Reliant UNIX fur ther upon request Windows NT 2000 XP LINUX SuSE Red Hat Debian further upon re quest Windows NT 2000 XP Windows NT 2000 XP Windows NT 2000 XP LINUX SuSE Red Hat Debian further upon re quest UNIX SUN HPUX TRU64 AIX Reliant UNIX fur ther upon request Windows NT 2000 XP LINUX SuSE Red Hat Debian further upon re quest UNIX SUN HPUX TRU64 AIX Reliant UNIX fur ther upon request Windows NT 2000 XP LINUX SuSE Red Hat Debian further upon re quest UNIX SUN HPUX TRU64 AIX Reliant UNIX fur ther upon request Windows NT 2000 XP 2007 SEP AG 24 SEPsesam Version 3 0 Chapter 3 The programs of SEPsesam SEPsesam consists of a number of C and Java programs which carry out an unobstructed appli cation flow through their cooperation on the server as well as on the client These programs can be found under ID bin and the subdirectories sesam sms db and gui 3 1 User Interface GUI Graphical User Interface The User Interface of SEPsesam is programmed in Java and can be installed on any co
47. RECOVER Blocksize 65536 IOO6 RECOVER Info i I007 RECOVER Last write 2004 02 20 10 00 19 1008 RECOVER Split savesets FALSE I009 RECOVER Next label Listing of savsets 1 SC20040219122608 Task job SESAM BACKUP Source 2 SC20040219122622 Task job ntpc23 all Source 3 SC20040219122611 Task job softnt15 all Source 4 SC20040219122611 Task job rsoftnt15 all Source 2007 SEP AG 83 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 6 DISASTER RECOVERY Enter number of saveset or q uit for exit gt 1 Do you want to copy files or create listing from saveset c 1 gt c Enter target directory means original place gt Allow overwriting of equally named files at target y n gt y Starting supervisor process SMS_WATCH in queue qu_tape_trans2 supervisor process SMS_WATCH now is started I011 RECOVER Restoring file listing of saveset SC20040219122608 on media WEEKO0002 I016 RECOVER Copied files of saveset SC20040219122608 on media WEEKO00002 to protocol in file opt sesam var prot recover_20040311100209 prt Listing of savsets 1 SC20040219122608 Task job SESAM_BACKUP Source 2 SC20040219122622 Task job ntpc23_all Source 3 SC20040219122611 Task job softnt15_all Source 4 SC20040219122611 Task job softnt15_all Source Enter number of saveset or q uit for exit gt q 6 2 Disaster Recovery under Windows For Windows Clients additionally the Backups of Registry resp System State mu
48. RS 33 3 3 1 9 sm smsinterface ee 34 3 3 1 10 smssms watch aoaaa 36 ide Gas te Sacer nun So vie teken stands Rod hea ab de Se nie atte de gs 37 3 3 2 SEPuler SEPsesam Scheduler o 2 000 ee eee 37 3 3 3 Queue Manager 0 i a ae E a a a E E E e E 38 3 3 3 1 Queue Manager Concept a 40 3 3 3 2 Queue per drive grOUpPl a ee 40 3 3 3 3 Tape end check for each drive o 40 pa bie RG eae ded BE TE bad 41 3 3 3 5 gue init for drive groups kn 41 3 3 3 6 Specification of a media pool and optional drive number 42 TE 42 3 3 3 8 Processing in case the desired drive is blocked 43 3 3 3 9 Lock drives a e o iea e i R a ie aa E a E e 43 3 3 3 10 Monitoring drive group queues ok 43 3 3 3 11 Jobs without media pool assignment 44 3 3 3 12 Logging of the Queue Manager programsl 44 2007 SEP AG 4 SEPsesam Version 3 0 SEP CONTENTS Global Storage Management Lcd a a EA ERED 44 3 3 5 Sesam Multi Streaam SMS 02020002022 eee 45 ee e dogs 47 3 4 Communication Server Client e e ee 49 3 4 1 Command execution at the Client CTRL Servicel 49 3 4 2 Command execution at the Client SSH secure shell 51 Cha MA MP SN EN Mena oe a kos aa a ee 51 3 6 Global Variables GEBV ll ez Beban Se he Wak SO maa 53 fe Fn AN On Sar oa ter Go Sens en
49. SEPsesam Administrator Manual SEP AG 83629 Weyarn Germany 17th August 2007 SEP Global Storage Manegament 2007 by SEP AG All rights reserved Any form of reproduction of the contents or parts of this manual must be granted by SEP AG in writing During completion of this manual SEP put high diligence on correctness and usability of the information contained in it SEP AG cannot issue a guarantee on the contents of this manual Hint This administrator manual is based on SEPsesam user manual ie the basic description of functionality is not repeated here This manual is to support the administrator during installation starting configuring and problem free upkeep of the SEPsesam software This document is kept under CVS identification Id admin_manual tex v 1 19 2007 01 25 08 42 25 sesam Exp 2007 SEP AG 2 SEPsesam Version 3 0 Contents 1 Introduction 1 1 Storage Management 1 1 1 Availability of Data na 1 1 2 Secutity ot Data ejido Both ao eos a Rhee EE semak 11 3 Backup of Datal a LLA Restore of data dae 2 bel BN bean Se e an Rn Se SG 1 1 5 Disaster Recovery 12 Objects of SEPsesam ann oa an a a Uu UN 2 Installation 2 1 Directory structure 2 2 sm_setup 2 3 Installation on UNIX and LINUX 2 3 1 UNIX Backup Server e 2 3 1 1 Software Reguirements o 0000 e O oo O ON N 231 2 Imstallati0Ml
50. STPD Logging The scope of logging files can be specified by the user in the files ID var ini sms ini resp stpd ini Possible values are 0 ERROR 1 EMERGENCY 2 WARNING 3 NOTICE 4 INFO 5 DEBUG 6 TRACE These are specified in the INl files under the section SMS Logging resp STPD_Logging in the following Form SMS Logging Log Levels 0 1 2 gt up to Level 2 Example STPD Logging Log Levels 0 1 2 34 5 6 gt up to max Level 6 Example The logging files are stored under ID var log sms 2007 SEP AG 68 SEPsesam Version 3 0 Chapter 5 Administration 5 1 Start and stop the Server SEPsesam offers a simple interface to start and stop the server The system is equally started with sm_startup e g Reboot of a W2K Server as well as with sm main start e g Start over the command line This is achieved in the following way During the processing of sm_main start after the start of all Daemons resp Services the common sesam processing queue qu_all is initialized and then the program sm startup is started there sm_startup checks the SEPsesam environment and starts sm_config drives for Initialization of the drives If the SEPsesam Server is started with sm_startup it checks with sm_main status if the Daemons resp Services are active If they are not active sm_main start is called and sm_startup terminates prematurely The command to stop SEPsesam Server is s
51. again Syntax sm sms interface command options Initialization of a media sm_sms interface init d Device B Block size Default 65536 t Label Tape ID i Tape Info r Rewind Flag Default R T Timeout Default 120 Example sm sms interface init d Tapel t S00007 7 i Info r R T 60 Read the media label sm sms interface getlabel d Device r Rewind Flag Default R T Timeout Default 120 2007 SEP AG 38 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management Example sm_sms_interface getlabel d Tapel r R T 60 Read the tape contents sm_sms_interface dir d Device Example sm sms interface dir d Tapel Read the Tape Trailer contains possibly following tape label sm sms interface read tape trailer d Device Example sm_sms interface read tape trailer d Tapel Write the Tape Trailer sm sms interface write tape trailer d Device t Label Tape ID 1 Next TapeLabel i TapeTrailerInfo e EOMFlag Default F FALSE g EMRGFlag Default F FALSE Example sm sms interface write_tape_trailer d Tapel t S00001 7 1 500008 i Info e T g T Unload the drive sm sms interface unload d Device Example sm sms interface unload d Tapel Write data on the media sm sms interface backup file d Device t Label Tape ID f Source File Name s Saveset Name i Saveset Info I Interpreter Default none Exampl
52. and line the standard value unknown is used So we have the following sm gm submit lt queue name gt lt allocate gt lt resource gt creates a job with Entry Number in the specified Queue optional allocate Default unknown preferred Resource lt starting time gt Format hh mm lt starting date gt Format dd mm yyyy lt priority gt Integer lt job name gt Identifier lt file gt fully qualified program name lt par1 gt lt par8 gt optional max 8 parameters Example 1 Job oracle_P01 with media pool ORACLE on drive group loaderl sm gm submit loader1 ORACLE 12 00 04 04 2001 3 oracle PO1 opt sesam bin sesam sm auto backup 1 F T 12 00 04 04 2001 W 14 00 04 04 2001 m ORACLE oracle PO1 Example 2 Job linux1_full with media pool FULL on drive group loader1 with Drive num 1 sm gm submit loader1 FULL 1 12 00 04 04 2001 3 oracle PO1 opt sesam bin sesam sm backup 1 F T 12 00 04 04 2001 W 14 00 04 04 2001 m FULL linux1 full 3 3 3 7 Drive number specification to a starting program When a job is started in the executing queue it needs the drive number This number is therefore specified as additional parameter at the start of the corresponding program e g sm_backup on the command line d drive number Call over sm_qm submit without d 2 sm backup j SESAM BACKUP m DISK d 2 the resource is specified by sm_qm_main A called sm_backup receives as an argumen
53. be restarted with sm main reload rmi A runtime change is not implemented in the concept of Java for security reasons The syntax for pathnames in the sm_java policy is platform dependent e In order to test if there are problems with the Java Security the line permission java security AllPermission can be un commented In this way the restriction to explicitly 2007 SEP AG 96 SEPsesam Version 3 0 SEP 9 2 ERROR MESSAGES OF THE KERNEL SOFTWARE Global Storage Management specified rights is switched off To avoid security holes this line after the test should be commented out again 9 2 Error messages of the kernel software Network problems belong to the most often error causes i e a computer does not run without problems and or the hardware technical connection to it is corrupt Here the operator must take care that the communication runs without problems Network Check NW Check Network Check With the help of standard communication programs the connections and the address resolution must be checked ping nslookup address resolution etc Additionally the connection must be checked with the corresponding SEPsesam access program CTRL SSH see 3 4 The address resolution must be consistent i e if for a TCP IP name the resolution gives an IP address then the resolution for that IP address must give the same TCP IP name Example nslookup decunix Server seplinux2 sep de Address 193 28 59 40 Name de
54. click on this link starts the GUI of SEPsesam if the Kernel processes run see 3 5 Deinstallation 1 Start Programs SEP Aktiengesellschaft Unistall or 2 Start Settings Control Panel then choose the folder Software and start the SEPsesam Uninstall Routine or 3 With the call sm_setup delete 2 5 Installation on OS 2 On OS 2 only Client can be installed cd Installation directory sm_setup make_client server see With server the name of the SEPsesam Server is given Deinstallation of the Client sm_setup delete 2 6 SEPsesam Client Supported operating systems SEPsesam Clients are available for the following operating systems For UNIX operating systems can be said that generally all UNIX systems are supported Further Clients upon request e OS 2 e PowerMAC_OS e UNIX 2007 SEP AG 22 SEPsesam Version 3 0 SEP 2 7 SEPSESAM CLIENT SUPPORTED ONLINE MODULES Global Storage Management AIX from 4 1 BSD Digital UNIX Tru64 from 4 0x HP UX Vers 9 10 and 11 IRIX LINUX Kernel 2 2 x 1386 and 1A64 OSF1UX SCO UNIX SINIX Solaris on Sparc since 2 4 Solaris on i386 since 2 4 ULTRIX e VMS from 7 0 e Windows Systems NT 2000 2003 XP 2 7 SEPsesam Client Supported Online Modules For the Backup of following databases resp applications special Backup clients are available 2007 SEP AG 23 SEPsesam Version 3 0 SE
55. cunix sep de Address 193 28 59 94 nslookup 193 28 59 94 Server seplinux2 sep de Address 193 28 59 40 Name decunix sep de Address 193 28 59 94 In cases where under Cause Solution only gt support sep de appears an analysis of the logging file is necessary which must be sent for this purpose to the Support support sep de tells you which files are necessary Hint Under val appear in the messages the corresponding actual values 2007 SEP AG 97 SEPsesam Version 3 0 SEP Global Storage Manegament CHAPTER 9 PROBLEM ANALYSIS AND SOLUTION 9 2 1 BACKUP problems at backups Error message Cause Solution E001 BACKUP Error during working on PRE interface of backup val val Bug in the PRE Script gt user programmed Authorization not configured gt see NW Check E002 BACKUP Cannot submit SMS_WATCH process to queue val Queuemanager is not running gt sm shutdown sm startup E003 BACKUP Could gv bck msg val val not read support sep de E004 BACKUP val val common error gt support sep de E005 BACKUP Error during working on POST interface of backup val val Bug in the POST Script gt user programmed Authorization not configured gt see 3 4 gt NW Check E006 BACKUP val error please view backup protocol Error during data transfer gt Backup protocol to support sep de E007 BACKUP Invalid
56. de list file Argument c Invalid verbose level specified max 3 SBC_COM_INTERFACE call failed s Error checking the include list specs As Error allocating include list specs buffer 2007 SEP AG 28 SEPsesam Version 3 0 SEP 3 2 SESAMBACKUPCLIENT SBC Global Storage Management s COM 1077 E_ERROR Answer buffer empty COM 11078 E_ERROR SESAM server answer proccessing failed s ITEM 1079 E ERROR Archive could not be resyncronized Exiting COM 1080 E ERROR c Invalid operation initiator specified CLI 1081 E ERROR c Invalid argument max value exceeded CLI 1082 E ERROR c Operation unspecified Lopen openjob closejob close CLI 11083 E ERROR c Operation Lopenjob closejob close requires the session ID argument CLI 11084 E ERROR c Operation open doesn t need the session ID argument COM 1085 E_ERROR CWD command assembling failed COM 1086 E_ERROR RETR command assembling failed MSEX 11087 E ERROR Invalid backup source s MSEX 1088 E_ERROR MS Exchange server not specified MSEX 11089 E ERROR MS Exchange server path not available s MSEX 1090 E_ERROR Cannot establish connection to remote Sesam server MSEX 11091 E ERROR Unable to open file s d MSEX 1092 E_ERROR Backup operation failed MSEX 11
57. e 25 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM sbc brgpkh C lt control_host gt d lt device gt f lt list_source gt F lt data_format gt i lt saveset_info gt j lt job_name gt I 1 lt level gt L lt control_target gt n lt segment_number gt o lt restore_type gt O lt STOR RETR_direct gt R lt restore_target gt s lt saveset_spec gt S lt storage_node gt I t lt tape_spec gt T lt since_time gt x lt exclude_patterns gt X lt exclude list gt v lt level gt lt szBackupSource 1 gt lt szBackupSource 2 gt lt szBackupSource n gt lt szRestoreSpec 1 gt lt szRestoreSpec 2 gt lt szRestoreSpec n gt b Backups the data of a Client on the drive of another com puter r Restores the files at the Client p Copies a file in ASCII Mode from the own computer to an FTP Server g Copies a file in ASCII Mode from an FTP Server to the own computer h Help printout on the Standard Output and Program Break d device Source or target on a computer for a Backup or Restore o frestore type Describes different Restore possibilities r ename p lain over write n ext R restore_target Relocation of the Restore directory structure s savesetname Name of the Saveset S storagenode Server or Storage Node v level Sets the Verbose Level Example Backup The files are backed up from a WindowsNT computer to a UNIX c
58. e sm sms interface backup file d Tapel t S00007 7 f x dat s x sav i Saveset Info Read a saveset from the media sm_sms_interface restore file d Device t Label Tape ID f Target File Name s Saveset Name i Saveset Info Example sm sms interface restore_file d Tapel t S00007 7 f x dat s x sav i Saveset Info Create the LIS and SGM Files from a Saveset on the media 2007 SEP AG 39 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM sm sms interface restore listing d Device t Label Tape ID n Start Segment Default 0 b Number of Blocks Default 0 s Saveset Name i Saveset Info I Interpreter Default none Example sm sms interface restore_listing d Tapel t S00007 7 n 15 b 150 s x sav i Saveset Info Restore of a Saveset directly from the media sm_sms interface restore emergency d Device t Label Tape ID f Target Pipe Name n Start Segment Default 0 b Number of Blocks Default 0 Example sm sms interface restore_emergency d Tapel t S00007 7 f sesam n 15 b 150 Restart SMS sm sms interface restart sms d Device Example sm_sms interface restart sms d Tapel Read again the changed configuration for the running SMS sm_sms interface reread_ini d Device Example sm_sms interface reread_ini d Tapel Inquire SMS Device Status sm_sms interface inguire status d Device Example sm sms in
59. e sm ctrlc p 11301 l root qslinux1 sep de sbc 3 4 2 Command execution at the Client SSH secure shell Sesam can also use the ssh protocol for command execution at the Backup Client The requirements are that at the Server an ssh Client program and at the Backup Client an sshd Service Daemon is installed and the Server can login to the Client without a password as user root for UNIX and system for Windows This is achieved through the creation of a private and a public key on the Server and the transfer of the public key to the Backup client Details can be found in the documentation of the corresponding SSH implementation In case firewalls are used between the SEPsesam Server and the Client the port usage can be restricted with ssh options see 5 6 The options are specified in GUI Clients Properties in the field Access Options 3 5 Processes and Dataflow SEPsesam creates and uses the following background processes Services sm main H exel Sesam main process sm_sepuler exe SEPuler sm_db_main exe Database sm_qm_main exe Queue manager java exe Java for GUI sm_passd exe Access control sm_ctrld_main exe CTRLD Daemon sm_sms_main exe SMS Server sm_data_server exe SMS Dataserver Drive 1 sm_data_server exe SMS Dataserver Drive 2 sm_stpd_main exe SesamTransferProtocolDaemon STPD 2007 SEP AG 55 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS
60. e that the executing Queue is deallocated or the executing Queue is already identically allocated Attribute allocate is the same Additionally a pre selection of the executing Queue t m a specific executing Queue drive can be given for a job Attribute Preferred Resource 3 3 3 3 Tape end check for each drive The SEPsesam process sm_sms watch is used to monitor the physical end of a media during a Backup or Restore It checks the drive state and transfers the drive information Throughput Status etc to the SEPsesam information system see also 3 3 1 3 2007 SEP AG 44 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management This process runs in its own queue per drive namely the queue qu_tape_trans Drive Num ber In this way it is guaranteed that this process monitors the drive independently of the state of the drive group 3 3 3 4 Processing of the Jobs The processing of Backup tasks is done in the drive group Queues The Jobs are processed according to priority and FIFO first in first out The program looks for an available drive t m the first drive which is allocated for the de sired media pool and still has place for the Backup task If no such drive exists then the first deallocated drive is used If all drives are allocated the program according to FIFO looks for the next job with the same priority but other media pool Backups with
61. e label already exists in the media archive loader and slot are adjusted If the label is not in the media archive the media is introduced in the media archive with check of the label format if i introduce is specified The contents of database tables media and loader_contents are updated and an entry in the daily protocol is created Input parameters 2007 SEP AG 37 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM Switch Description l num Loader number d num Drive number i Introduce Flag introduce leads to introduction of new resp unknown media in the archive t type Media Type only when i also specified m pool Media pool only when i also specified s num Slot Count Specified if not all slots are served Syntax xx yy z B 0 9 C Flag if the media label should be additionally checked independently from the recognized bar code v Verbose Flag 0 1 2 h Help Output to the Standard Output and Program break Example sm robot l 2 d 1 i t THXKD m E s 2 7 cv gt gt Introduction of all unknown media in Slot Area 2 7 sm_robot l 2 d 1 gt gt Archive adjustment 3 3 1 9 sm sms interface The access to SMS Media Tapes Disks is implemented in the sm sms interface program The most important calls are the determination of label Get Label and the initialization of media with a new media label Initialize In case of a problem the tapes can be labeled
62. e noe es gees ios ee 54 371 sm slu A d ai G Bi esad a i T deei id Da a E Taa U a i i ie e i 54 3 72 sm slu INgU TY s s w on i i i a a ka ai oi e ei ai on i a i o W a a 55 3 7 3 sm slu mode sensel aa a 55 3 14 sm slu read element status aa ee 56 3 15 sm slu read element status with label o 57 3 7 6 sm slu move Medial 57 3 7 7 sm slu unload for tapes ee 57 32 9 sm slu load cg PS dok dn ake bob eas abon again 57 3 0 9 sm slu rewind 2 2 a 57 3 7 10 sm slu allow removall e e 57 3 7 11 sm slu prevent Temoval e 57 3 112 smslureset e 58 59 Al Status Protocol 46 eu a ee mono te Pembela ba Ra eee ee he eH 59 42 Daily protocol oem ara EG nan PO Oe a a ee ee Rp 60 43 Backup protocol sc ee ee ee ea 60 4 4 List of the saved files e 61 A NO ANA 61 4 6 Analysis protocols Logging e ee 61 4 6 1 Logging of the Kernel programs e e 61 4 6 2 sm db main Logging 2 0 0 0 0 000200000002 0200048 62 46 8 SMS STPD Logging speak esa pak REDE ER RRA RE oS 64 2007 SEP AG 5 SEPsesam Version 3 0 SEP Global Storage Management CONTENTS 65 5 1 Start and stop the Server aa 65 5 2 Reboot configuration automatic start ee ee 65 5 3 Functionality check o o e 66 A E AN 67 5 4 1 GUl Server commands
63. ed Remote system type is Linux ftp gt cd SMS disk7 INQUIRE 250 CWD Command successful 2007 SEP AG 51 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM ftp gt quote site inquire 213 SMS Inquire status begin STATUS SMS_WRT OP COUNT BLOCKS 0 000000 AMOUNT BYTES 91553792 000000 THROUGHPUT GB H 2 504883 213 SMS Inquire status end ftp gt bye 221 Service closing control connection Hint User must be STPD User sms or System User With cd SMS tape login type the SMS Dataserver is connected The tape must be selected according to the entries in ID var ini sms ini e g Tape0 WNT dev nst0 Linux dev nrmtOh UNIX or disk1 for DISK device As login type SHARE is used for parallel Backups EXCLUSIVE for Restores and IN QUIRE for queries On errors react according to the error message e g correct the input or wait for resp change the state of SMS Dataserver On SMS not in allowed state it is EXCLUSIVE Restore busy In this case it is only possible to create a connection to the Dataserver with login type INQUIRE Backup Test With the following FTP command a file can be transferred to the inserted media Put File Saveset device analyzer tape ID tapelabel IP Buffersize e g put test dat SF123 dev nvrmt0h cpio 4 S500004 32 analyzer none no Analysis cpio cpio Format mtf mtf Format Restore Test With
64. em description The Command event makes possible the execution of any programs at the Backup Client For security reasons the execution must be restrictable The access security of a computer is a responsibility of the corresponding system administrator Only he may issue resp disable an access right For access restriction on UNIX systems files are created at the computer which explicitly allow resp disallow an access as e g the file etc ftpusers The following sequence was established based on its simplicity and robustness 2007 SEP AG 73 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 5 ADMINISTRATION e simple modification of the access rights through modification of the file e simple overview of the actual rights through output of the file e secure management through exclusive root access files in etc can be edited by root only For access restriction on WNT Systems entries in the registry can be used The Registry respects all WNT user rights and allows access to entries according to the corresponding rights only A surveilance of the entries is supported 5 5 2 Command restriction on UNIX systems For the restriction of SEPsesam command events the file sesam_cmdusers allow in directory etc is used A command event can be executed only if the user as well as the file name of the program to be executed are present in etc sesam_cmdusers allow Format of the file etc sesam_cmdu
65. ename Ressource starts the Queue after stop or block submit Queuename Program sets Program in the Queue under an entry number Arguments job_sho Queuename Jobname shows Entry number and Status for count Job Count name del entry Entrynumber terminates the job process selected through its Entry number shutdown terminates the sm_qm_ main process delete Queues and Jobs Example sm gm h Id admin manual tex v 1 19 2007 01 25 08 42 25 sesam Exp Usage sm gm command command as shown below block queue resource blocks queue s holding and pending jobs delete queue deletes the queue init queue resource job_limit creates queue with job limit every resource defines an executing queue sho queue all shows queue or all queues with file names sho name queue all shows queue or all queues with job names sho full queue all shows queue or all queues with parameters start queue resource restarts queue or resource stop queue resource stops queue or resource and kills running jobs submit f queue allocate resource al1 starting time format hh mm 2007 SEP AG 43 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM starting date format dd mm yyyy priority starting priority integer job job name as you like file full qualified file name to execute argument optional job arguments for execution creates
66. ents of the drive Unload button of the drive is blocked With the option allow removal the lock can be removed 2007 SEP AG 61 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM 3 7 12 sm_slu reset To avoid the parallel execution of SCSI commands slu uses internally a semaphor mechanism It creates for the duration of the SCSI call a lock file for the corresponding SCSI ID If the command is terminated in this phase the lock file remains With the command call slu SCSI ID reset the lock file is removed 2007 SEP AG 62 SEPsesam Version 3 0 Chapter 4 Protocols and Listings SEPsesam creates on the Sesam Server a number of protocols which give information about the work and the status of Backups and Restores 41 Status protocol For each SEPsesam Backup day this is the period of time which is fixed by 2 following SEPsesam day changes a status protocol is written Here for each Backup task comes an entry about the end status of the Backup in a file with the beginning date of the SEPsesam Backup day ID var prot yyyymmdd status In the user interface GUI can be found under Protocols Status At the beginning of each row a flag is set with the following meaning 0 successful 1 successful but with warnings 2 Listing incomplete 3 terminated c terminated by user GUI X Fatal error Example Start of SESAM Backup day at 2002 11 12 08
67. esam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM Switch Description d drive number j SEPsesam task o stop nostop disk info f file F file R target path Return value s SEPsesam drive number filters savesets of this task SEPuler default nostop LINUX disk info restore containing SEPsesam restore command from desaster information for ex the data restore is directly started without scanning the media containing output of a media scan new target no trailing slash for o disk info default mnt disk e listing of savesets on tape or e restores selected saveset from tape to target dir Example sm_recover 3 3 1 7 sm_restore Description Main Restore program e makes the necessary media available e sorts the list of the selected files selective Restore according to the LIS file e controls the execution of the specific Restore programs e controls the Generation Restore e protocols the proceeding in Database Protocol files 2007 SEP AG 36 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management Parameter Description P1 Target computer User Execution counter of the Backup run or Restore task Start time Format Start time YYYY MM TT hh mm ss for restart of a Restore task here no further parameters necessary P2 Drive number Interface P3 mode new over not syste
68. esamserver var vardir Installation of a client sm_setup make_client sesamserver var vardir Deinstall a SEPsesam Product sm_setup delete Change of the SEPsesam configuration Make possible GUI access from another computer sm_setup allow gui gui user Assign another server to the GUI Execution at the GUI client sm_setup set_gui sesamserver Set Reboot Script for the client or the server sm_setup set_reboot client server set_reboot_script Allow access for a server to the client Entry at the client sm_setup set_client sesamserver Example sm setup allow gui pc21 admin Usage of sm setup for Installation and Update Reguirements Own directory with the packed kit sm setup and if available the unzip Tool Call sm_setup without parameters 2007 SEP AG 12 SEPsesam Version 3 0 SEP 2 3 INSTALLATION ON UNIX AND LINUX Global Storage Management 2 3 Installation on UNIX and LINUX 23 1 UNIX Backup Server 2 3 1 1 Software Reguirements e The server must be able to resolve the client and vice versa e The client and tapeserver do not need JRE Java Runtime Environment e SUN Java Runtime Environment JRE 1 4 2 or higher e CLCMC314 SCSI CAM Media Changer Driver V3 10 for Loader Tru64 Unix only e Acrobat Reader higher equal 4 0 e Working name resolution IP names and addresses correct DNS or proper entries in etc hosts Supported operating systems Operating system Version Service Pack e Linux i386
69. esponding DBF files are stored under ID var db schema sesam The database is controlled by the DB Server sm_db_main see 3 5 The table structure of the DB is not shown here explicitly but can be requested if neces sary from SEP AG as an SQL file 2007 SEP AG 48 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management At the command level the DB can be accessed with S L Instructions using the program ID bin sesam sm_db exe Syntax sm_db SQL Instruction sm_db SQL Select Instruction export gt File gt Contents in the form of SQL Insert Instructions for Re import Another program for DB processing is ID bin sesam sm_dbf_pack exe The DBF files constantly grow in size because the deleted data sets are not actually deleted but only marked as deleted To avoid that the DBF files can be packed with the help of sm_dbf_pack t m the data sets which are marked as deleted will be really deleted Additionally the DBF files can be analyzed Syntax sm_dbf_pack p P a A DBF filename dbf records file name p pack all Sesam DBF files no further arguments P pack the specified DBF 1 argument a analyze the specified DBF output all bytes numbered 1 argument A analyze the specified DBF all records 1 argument The automatic day change of SEPsesam NEWDAY Event makes among other things the packing of all DBFs The execution can be suppressed through
70. fixed drive assignment selection are started in the corresponding drive as soon as it is suitable for them not used resp allocated for the desired media pool The processing is started when e a new job is brought in the drive group queue submit e a Job goes from the holding queue to the pending queue Expiration of the holding time e a place in an executing queue is free t m a job in a drive queue is finished The processing of the drive group stops when e all jobs with the actually highest priority are processed e there is no free place in the drive queues A deallocated drive is reserved through an allocation for the corresponding media pool The Backup task attempts to find and load an available media A new media is requested if necessary 3 3 3 5 que init for drive groups The call for the creation of a drive group queue follows below sm gm init lt queue name gt lt resource gt lt job_limit gt Example sm gm init loader1 1 2 3 5 Drive group loader1 Drive Numbers 1 2 and 3 Joblimit per Drive is 5 2007 SEP AG 45 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM 3 3 3 6 Specification of a media pool and optional drive number When a job is submitted in the queue the attribute allocate must contain the desired media pool If additionally a drive number is specified it must be transferred as well If allocate is not specified on the comm
71. hat it in case of disaster is available for a Restore via SEPsesam After the installation of SEPsesam in its var directory resides a file var skel templates sm_disaster sm disaster cmd in Windows which the user can copy to bin sesam sm_disaster sm_disaster cmd and can edit up to his wishes This procedure is executed by all Backups whose names contain DISASTER or SESAM in case of success 2 arguments are transferred along e the label of the currently used media e the complete Restore command with which the data of the saveset can be restored The Disaster strategy then looks as follows e the user sets up at least 1 Backup with a suitable name e g SESAM BACKUP which saves the var directory of SEPsesam so are saved Listings Loggings Database INI files etc e This Backup should run daily with mode COPY or FULL e The user programs sm_disaster cmd in a way that the contents of both input arguments are copied from SEPsesam computer to other computers at specific places Emails file copies Diskettes etc So the information when and on which media was performed the last own Backup of SEPsesam is available 81 SEP Global Storage Management CHAPTER 6 DISASTER RECOVERY In the real case after the computer is repaired the following steps are necessary e Re install SEPsesam from the distribution kit e at the defined place find out which media contains the last own Backup of SEPsesam and
72. he corresponding subcommand in our example dir is searched Examples a Access for user oracle program sm oracle client Key HKEY LOCAL_MACHINE SOFTWARE SEP Elektronik GmbH sesam CommandEvents oracle sm_oracle_client necessary with any value b Access for user informix with any program Key HKEY LOCAL_MACHINE SOFTWARE SEP Elektronik GmbH sesam CommandEvents informix necessary with any value c Access for user Achim with any CMD command Key HKEY LOCAL_MACHINE SOFTWARE SEP Elektronik GmbH sesam CommandEvents Achim cmd necessary with any value 5 6 Configuration of a Firewall SEPsesam makes possible the restriction of used ports for the implementation of Firewalls Field clients access_options The value of this field e g s o port first last is used directly for the remote call This field is freely editable GUI because the options which make sense are very different for the different access types CTRLD SSH Example about CTRLD With Port Range o appears the following sequence 2007 SEP AG 75 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 5 ADMINISTRATION SESAM Server FireWall Client CTRLD_MAIN listening on Port ctrld_port SM CTRLC Source Port random first free Port Source Port for CTRLD Client first free Port at the Client from first port ilast port Default unrestricted Target Port fctrld port SM CTRLC selects a local Port and connects to
73. in sesam sm_stpd_main exe is used as a special FTP Server for transfer of Backup data from the Client to the recording device Tape or disk drive over SMS see 3 3 5 The STPC STPClient creates a data transfer connection to the STPD over the network The FTP protocol is used for the transfer This guarantees a high data throughput and the compatibility with all network components The data is transferred directly to the recording device without intermediate storage comp german SEPsesam Patent Nr 4335836 and US Patent Nr 5 901 331 A special analysis of the Backup data makes possible the recognition of errors e g if dur ing the Backup a file changes in size At the beginning of Backup the file size is taken in the saveset If the file size changes during the Backup the analysis recognizes that and changes the file size so that the length specification remains consistent Additionally during the analysis the contents of the saveset Listing as well as the position data Segment Info is written in special files The process sm_passd is used by STPD for the authentication of system users see also 55 Syntax Check with ftp Default Port 11001 see ID var ini stpd ini STPD PORT ftp ftp gt open linux 11001 Connected to linux sep de 220 STP Service Ready Version 2 8 R16 PID 25854 Type HELP for list of commands Name linux root sms 331 Password required for sms Password 230 User logged in proce
74. is not equal SESAMROOT e g c WINNT and d Programme SEPsesam we have restore problems Therefore please change the file lt SESAMROOT gt var ini sm ini under PATHES the value of the variable gv_rw_tmp c temp To avoid that you should install the SEPsesam client preferrably there where your system resides 2007 SEP AG 88 SEPsesam Version 3 0 Chapter 8 Special modules Some optional modules will be described below Further Backup modulee e g ORACLE IN FORMIX SAP R3 are described in the corresponding documentation 8 1 Online Backup Restore Domino Server 8 1 1 System requirements Requirements at the Client e Lotus Notes Domino Server 5 0 8 e Sesam NT Client e g 1 5 1 14 Additional modules bin sesam e sbcln dll sm ini modification examples SBC_DATABASE DB_CLIENTS SBCLN sbcln dll sbc loads then the DLL with Keyword SBCLN databasename SBC_NOTES tmp_dir c lotus domino data tmp eventually create a Temp directory or set it to var tmp from Sesam SERVER sesam _server SesamServer Name 89 SEP Global Storage Manogement CHAPTER 8 SPECIAL MODULES set Set the PATH Variable after lotus domino nnotes dll 6 7 MB should be reachable and or lotus notes nnotes dll 6 7 MB 8 1 2 Full Backup Principle sbc b S softnt17 s notes sset SBCLN c llotus domino data nfs GUI Backup type Lotus Notes Example for source c lotus domino data bookmark nsf or nsf Attentio
75. ith sm_setup make client SesamServer see 2 3 3 UNIX Tape Server A Tape Server is a Client with extensions for the connection of RemoteDrive resp RemoteLoader see 2 3 2 sm setup make_node SesamServer sce 2 2 2 3 4 UNIX Interface GUI Requirement Java Runtime Environment JRE 1 4 2 or higher The operating system must have access to the SEPsesam CD Then you go to the directory which corresponds to the respective UNIX operating system The GUI installation is possible only if there is a Server Kit The dialogs of sm_setup offer the possibility of a GUE Installation sm setup make_gui SesamServer sce 2 2 The access rights of the GUl computer to the SEPsesam Server are defined on the server side in the file IV var ini sm_java policy A corresponding entry can be created on the server side with the following call sm_setup allow_gui c gut client u user m admin operator restore Example sm_java policy Unix GENERATED sm_java policy BY sm_setup Id admin_manual tex v 1 19 2007 01 25 08 42 25 sesam DO NOT CHANGE FORMAT DURING EDITING LINES grant ACCESS 2007 SEP AG 15 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 2 INSTALLATION permission java security AllPermission Allow GUI Server to refresh Policy do not comment permission java security SecurityPermission getPolicy NET permission java net SocketPermission 11301 connect accept res
76. ith extensions for the connection of RemoteDrive resp RemoteLoader Please start nt_srv VersionNr _ Languagedesignator exe from the CD see 2 4 5 Windows Interface GUI Please start nt_gui VersionNr _ Languagedesignator exe from the CD see Hardware Requirements for the GUI Main memory min 256 MB Software Requirements e Java Runtime Environment JRE or Java Development Kit JDK from 1 4 2 e Internet Explorer since version 5 or Mozilla Firefox for Online Help e Acrobat Reader since version 4 0 for Online Guide The access rights of the GUl computer to the SEPsesam Server are defined on the server side in the file TV varlinilsm_java po li cy A corresponding entry can be created on the server side with the following call 2007 SEP AG 20 SEPsesam Version 3 0 2 4 INSTALLATION ON WINDOWS SEP Global Storage Management sm_setup allow gui gui user Example sm_java policy NT Version GENERATED sm_java policy BY sm_setup Id setup c v 1 106 2002 11 06 11 11 55 sesam Exp FOR VERSION 2 0 1 13 DO NOT CHANGE FORMAT DURING EDITING LINES grant ACCESS permission java security AllPermission NET permission permission permission permission permission java net SocketPermission 11401 connect accept resolve java net SocketPermission 11301 connect accept resolve java net SocketPermission 21 connect accept resolve java net SocketPermission 25
77. m image if there is a amp inserted then the directory structure is rebuilt otherwise flat Restore in the target directory is performed P4 SEPsesam Backup task P5 Date of the Backup P6 Media label P7 Completeness Flag yes Full Restore should be performed or Time stamp the file ID var sel Timestamp sel contains the list of selected files P8 Target directory or ORIGINAL Syntax sm_restore P1 P2 P3 P4 P5 P6 P7 P8 or sm restore P1 Hint For selective Restores selection files are necessary They are created during the selection in the Restore wizard GUI or can be created with an editor from the existing LIS files Example sm restore sesamx DK 8 1 LOCAL not z sesam etc 04 04 2000 S00012 yes ORIGINAL The contents of the Restore task will be restored to the original directory Existing Original files will not be overwritten and no file tree structure will be built sm restore decuberlin root 1 1 over decuberlin te6 08 08 2001 DISK00003 yes usr test7 The contents of the Restore task will be restored to a new target directory Existing Original files will be overwritten sm_restore 20010802_101680 2001 08 08 14 32 28 Restart of a Restore task 20010802 101680 which has been previously created 3 3 1 8 sm_robot Kernel program for the GUI Components Loader Content Archive Adjustment Checks all labels of media in the slots of the loader magazine If th
78. m Bad media etc an attempt is made to take a new media from the SPARE pool into the given one Switch Description d drive number sesam internal number of the drive m media pool Name of the media pool not used if t is also specified t label Label with which the media should be initialized L type optional login type default empty eom backup from internal control i identifier optional identification for this execution is set internally Output exits with 0 1 ok error writes GLBV gv init msg drive number really initialized media 3 3 1 5 sm loader Kernel program for the so called Loader handler in GUI Components Loader Loader action Lays a layer over the Sesam Loader Utility SLU comp 3 7 Description Loader program for coordination of the loader functions Performs reload seguences keeps the database consistent sets the Mount State writes protocol messages in the SEPsesam daily protocol sm_loader import export load unload show further switches 2007 SEP AG 34 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management Switch Description import transfers a media from an IO Port to a slot and transfers the slot infor mation for the media label to the media archive in case that the media label can be determined using a bar code and the media was already initialized export transfers a media from a slot to an IO Port and removes the correspond
79. m_shutdown which calls sm_os_startup stop It then uses a o sm main stop to stop the Services Daemons 5 2 Reboot configuration automatic start SEPsesam is designed so that it starts automatically after the system boots To suppress that the following steps are needed Under Unix Systems Change to the bin sesam directory and enter sm setup unset reboot To enable the ser vice again enter sm setup set reboot Under Windows Systems WNT Start Settings Control Panel Services 69 SEP Global Storage Manogament CHAPTER 5 ADMINISTRATION Select SEPsesam Server resp SEPsesam Tape Server Select Start type then select Disabled The service sesam Multiplexing Server 0 must be disabled as well Windows 2000 Windows XP Start Settings Control Panel Then go to folder Administration and select Services Double click on SEPsesam Server resp SEPsesam Tape Server for Start type use Disabled 5 3 Functionality check To check SEPsesam components it is sufficient to use the display GUI current messages and to start a Backup task from the GUI Immediate start Backup The Backup should run and show throughput quantities The functionality check was successful when the Backup finishes successfully Functionality check sequence GUI Display current messages Possible RMI errors RMI Server at SEP sesam Server does not have socket connection to lt Service Address g
80. mputer with Java Runtime Environment JRE from 1 4 2 It communicates with the SEPsesam Kernel over the JAVA components RMI RemoteMethodIn vocation and JDBC JavaDatabaseConnectivity The JRE JavaRuntimeEnvironment contains the Java Virtual Machine JVM and is used for the execution of commands entered through the user interface The RMI Server implemented in Java processes the calls at the SEPsesam Server It uses a JDBC ODBC Bridge for the access to the SEPsesam database and a CTRLD Socket connection for the direct call of SEPsesam programs 3 2 SesamBackupClient SBC The SBC is the essential Kernel module for the data Backup resp Restore The corresponding program sbc exe resides on the SEPsesam Server as well as on the Backup client The SBC collects the data at the Client during Backup packs it in a channel and sends it according to the XBSA Standard X Open Backup Service API to the SEPsesam Transfer Protocol Daemon STPD which writes the data onto the target storage media During a Restore the data is read from the media sent to the Client over the channel received there by the SBC and distributed in the target files The data is transferred with an own ftp library to resp from the corresponding STPD Server SBC uses on UNIX Systems the Backup command cpio with Large File support while on NT Systems the NT specific MTF Format is used and the Backup resp Restore is performed in own modules Command sb
81. n Keyword SBCLN for Backup type Lotus Notes it is taken from the SEPsesam DB table task types and automatically inserted before the source specification 8 1 3 Full Restore Shut down the Domino Server Principle sbe r S softnt17 s notes sset SBCLN c lotus domino data nfs In the GUI over corresponding selection in the Restore wizard 8 2 Online Backup Restore MS SOL Server 8 2 1 System reguirements Reguirements at the Client e MS SQL Server 7 0 8 2 2 Description MSQL MS SQL 7 0 consists of several Windows NT services the main service is however MSSQLServer 2 further services are MSDTC and SQLServerAgent The databases reside at a standard installation under mssgl7Vdata as both data mdf and log file 1df The actual names for the Backup source e g SBCMSQL pubs are selected with Enterprise 2007 SEP AG 90 SEPsesam Version 3 0 SEP 8 3 ONLINE BACKUP EXCHANGE SERVER 5 5 Global Storage Management Manager With sqlmangr exe Enterprise Manager allow system user for the corresponding tables double click under location sglserver database users so the Backup and Restore can be started in the background 8 2 3 Full Backup Principle sbc b S decunix 11001 s sql sset d tmp SBCMSQL pubs GUI Backup type MS SQL Server Example for source pubs Attention Keyword SBCMSQL for Backup type MS SQL Server it is taken from the SEPsesam DB table task_types and automatically inserted before the
82. n angegeben gt ID var db schema sesam dbf E002 DBFPACK Missing 3 parameter for op tion P gt sm dbf pack h Usage E003 DBFPACK Missing parameters for option 1 gt sm_dbf pack h Usage E004 DBFPACK Missing parameters for the DBF analysis gt sm_dbf pack h Usage E005 DBFPACK Cannot open file val val to read gt wrong DBF name specified gt ID var db schema sesam dbf E006 DBFPACK Cannot open file insert tmp to write gt Check ID var work E007 DBFPACK Record lt val gt has wrong length gt supportOsep de E008 DBFPACK Cannot open file val val to insert new counter gt supportOsep de 2007 SEP AG 102 SEPsesam Version 3 0 9 2 ERROR MESSAGES OF THE KERNEL SOFTWARE SEP Global Storage Management 9 2 8 DRIVES Problems with drives Error message Cause Solution E001 DRIVES Wrong media val during at tempt to mount on drive val gt Change the media with a loader or manually gt Check the media label Archive adjustment or sm drive info Drive Nummer E002 DRIVES Could not read label from media in drive val SMS Server is not running gt sm shutdown sm startup Media is defective gt replace E003 DRIVES Drive val currently not online val as E001 DRIVES E004 DRIVES gv rosms not yet defined please check INI and restart gt sm startup
83. ngle port Allow for the Sesam Server a connection from any Source Port to the Client ctrid port 2 Case port range Allow for the Sesam Server a connection from any Source Port to the Client ctrid port and first port last port Firewall configuration Tape Server to Client Tape Server in the local network Data transfer from the Client to the Tape Server incoming calls Allow for the Client a connection from Source Port first port last port to the Tape Server stpd port outgoing calls Allow connection from Tape Server any Source Port to the Client first port last port 2007 SEP AG 78 SEPsesam Version 3 0 SEP 5 7 CONFIGURATION MASTER SERVER Global Storage Management 5 7 Configuration Master Server For the configuration of SEPsesam Server as a Master Server an entry in the database table defaults is necessary sm_db insert into defaults key value user_ name values mastersesam 1 sesam makes SEPsesam normal server sm_db delete from defaults where key mastersesam again Attention This function needs a license 5 8 Licensing of the SEPsesam Server The SEPsesam Server is licensed after time computer name and TCPIP Address In ID var ini sm_lic ini are stored the licensed values and their encrypted variants License categories TIMEOUT Runtime in days since installation SERVER Name of the sesam Server TCPIP TCPIP Adresse of the sesam Server A negative result of
84. of a Windows client e ut_gui VersionNr exe Installation of a Grafical User Interface GUI on a Windows PC for a SEPsesam Server on the network e ut_srv VersionNr exe Installation of a SEPsesam Server on a Windows PC This archive contains the software for GUI Client and Tapeserver This archive allows an installation of a GUI or client too Please follow the instructions of the installation client The installation client leads the user through the respectively necessary steps 2007 SEP AG 19 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 2 INSTALLATION 2 4 1 Basic procedures The following steps are necessary to install the SEPsesam programs on Windows e Insert the CD ROM in the CD Drive of the computer With the help of Windows Explorer or some similar program search the CD ROM for a directory win32 and open this directory Here you will find the self extracting archives exe and the readme txt files The readme files must be read before the installation The corresponding exe file is called and so the archive is unpacked in a temporary one and the user chooses the respective program and the IV All specifications are done in a dialog 2 4 2 Windows Backup Server Please start nt_srv VersionNr _ Languagedesignator exe from the CD see 2 4 3 Windows Client Please start nt_cli VersionNr _ Languagedesignator exe from the CD see 2 4 4 Windows Tape Server A Tape Server is a Client w
85. olve permission java net SocketPermission 11401 connect accept resolve permission java net SocketPermission 21 connect accept resolve permission java net SocketPermission 25 connect accept resolve permission java net SocketPermission 127 0 0 1 connect accept resolve permission java net SocketPermission abas connect accept resolve permission java net SocketPermission localhost connect accept resolve permission java net SocketPermission nimbus connect accept resolve ETC permission java util PropertyPermission read write permission java util PropertyPermission file encoding read permission java util PropertyPermission java rmi server hostname read permission java util PropertyPermission user dir read permission java util PropertyPermission user name read permission java lang RuntimePermission accessClassInPackage sun jdbc odbc permission java lang RuntimePermission loadLibrary JdbcOdbc permission java sql SQLPermission setLog FILE permission java io FilePermission etc sesam2000 ini read permission java io FilePermission var opt sesam var read write permission java io FilePermission lt lt ALL FILES gt gt execute permission java io FilePermission JdbcOdbcSecurityCheck write SEP permission de sep sesam gui server AdminPermission rootlabas permission de sep sesam gui server RestorePermission rs nimbus
86. omputer The files from directory c winnt are copied with increased Verboselevel 3 in the directory work to the Saveset my file safesetname 1 sbc b S miraculix s my file safesetname_1 v 3 c winnt Example Restore The previously backed up files are copied back to the directory c temp restore sbc r S miraculix s my file safesetname 1 o over R c temp restore 3 2 1 SBC Error codes The following list contains all possible SBC Error messages CLI 11001 E ERROR Option c requires an argument CLI 11002 E_ERROR Unrecognized option c J CLI 11003 E ERROR Double specified argument c 1004 E_ERROR Invalid function 2007 SEP AG 26 SEPsesam Version 3 0 SEP 3 2 SESAMBACKUPCLIENT SBC Global Storage Management CLI 11005 E ERROR Option c not available in this mode CLI 1006 E_ERROR Maximum number of backup files in command line exceeded XBSA 11007 E ERROR XBSA Call failed with message s 11008 E ERROR System call failed s XBSAx 11009 E ERROR XBSA Call BSACreateObject failed with message s XBSA 1010 E_ERROR XBSA Call BSAEndData closing saveset failed s FILE 11011 E ERROR Unable to open file s s 1012 E ERROR Undefined HOME environment variable 1013 E_ERROR Invalid function 1014 E_ERROR Invalid number of colon separated fields within save
87. ore Search for files sm_lis_db Activities Restore Build the tree for selective Restore sm_sho stream file pre Configuration Interfaces Pre sm_sho stream file post Configuration Interfaces Post sm_sho stream file alarm Configuration Interfaces Alarm sm_sho stream file disaster Configuration Interfaces Disaster in the lower display window sm_sho stream cur cyclic running display sm_break Terminate Backup resp Restore in the object tree left window sm_remote_tcpip Components Topology new Client UNIX sm_remote_wnt Components Topology new Client WNT sm_inventory Components Loader Contents Archive adjustment sm_loader Components Loader Loader action sm_config_loaders Components Loader new Loader Drive delete sm config drives Components Drives new Drive Drive delete sm arch new Components Media New sm arch rel Components Media Delete sm cal sheet Scheduling Calendar sheet sm sho stream pre Backups by Status Select Saveset Pre sm_sho stream post Backups by Status Select Saveset Post sm sho stream not Backups by Status Select Saveset Protocol sm daily schedule Scheduling Schedules Properties create change sm process sts Monitoring Processes sm drive sts Monitoring Drives sm_sho stream statprl Protocols Status sm_sho stream sesamprl Protocols Daily protocol sm sho stream lic License info 5 5 Access restriction for Command events 5 5 1 Probl
88. performed 3 3 1 11 sm startup Starts the SEPsesam Software e starts the background processes Services see 3 5 e prepares the drives and loaders e sets up the queues e sets up the actual SEPsesam Backup day 3 3 2 SEPuler SEPsesam Scheduler The SEPuler consists of the programs ID bin sesam sm_sepuler exe and sm_sepuler_cal exe sm_sepuler exe is started as a background process Service Daemon see 3 5 and controls events in the database table terms When the start time of an event is reached sm_sepuler exe calls the program ID bin sesam sm_sepul_event exe with the event parameters In ID var ini sm ini the following execution parameters for the SEPuler can be set SM_SEPULER gt Section for the SEPuler SLEEP 30 gt Working tact in seconds EVENT sm_sepul_event gt Event program 2007 SEP AG Al SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM The program ID bin sesam sm_sepuler_cal exe serves for processing of the Calendar sheet whose data is stored in the database table cal_sheets The logging of SEPuler programs is set in ID var ini debug ini see 4 6 1 SM_SEPULER 1 SM_SEPULER_CAL 1 SM_SEPUL_EVENT 1 So appear ID var log lgc sepuler lgc ID var log lgc sepul_ev_ Schedule name _ Time_stamp lgc 3 3 3 Queue Manager The Queue Manager is a software which creates and controls the Queues In a Queue Jobs can
89. plexStream dataserver SMS Server is not running gt sm_main reload sms E003 CONFDRI Automatic hardware setup and configuration finished with failure Please take a look into daily protocolerrors gt Configure loaders and drives through the GUI gt supportOsep de 9 2 5 CONFLOA Configuration Loader Error message Cause Solution E001 CONFLOA Could not find out the status of filling of loader newly installed loader gt Check the cables gt sm slu scan E002 CONFLOA Could not find out the drives of loader val val newly installed loader gt Check the cables gt sm slu scan E003 CONFLOA Could not find out the initial contents of loader val newly installed loader gt Check the cables gt sm slu scan 2007 SEP AG 100 SEPsesam Version 3 0 9 2 ERROR MESSAGES OF THE KERNEL SOFTWARE SEP Global Storage Management 9 2 6 DATABAS Problems with the database Error message Cause Solution E001 DATABAS Failure database val during access to gt support sep de E002 DATABAS DB SEL FIRST val cannot allocate memory gt supportOsep de E003 DATABAS DB SEL ALLOC val the recordlist is empty cannot allocate a new ele ment Element allokieren gt supportOsep de E004 DATABAS DB SEL ALLOC val can not allocate memory Check if the gt supportOsep de file system is full
90. rd on WNT Intersolv Driver Manager on Compaq unixODBC on LINUX is necessary at the GUI Server computer The Driver Manager controls all ODBC datasources For the SEPsesam database a datasource sesam_db must be configured The datasource is contacted over the oaodbc Driver and the oaodbc Client This Client communi cates with the SEPsesam database server sm db main and the corresponding datasource at the server 2007 SEP AG 71 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 5 ADMINISTRATION SEPsesam GUI Server ODBC Driver Manager RM SEPsesam GUI Client oaodbe drd ini Dra oadrd ini sm_db_main oadrd ini sm_ctric m_otrid Port 11101 Kernel Functions ODBC connection The requirements are automatically fulfilled upon a server installation 5 4 1 GUI Server commands A call of an interaction is redirected from the GUI over the RMI and from the RMI Server over CTRL to the module sm_gui request It prepares the parameters for the function calls and starts the necessary program The SEPsesam programs and the corresponding interactions for each GUI component Title bar lower windows etc are listed below 2007 SEP AG 72 SEPsesam Version 3 0 SEP 5 5 ACCESS RESTRICTION FOR COMMAND EVENTS Global Storage Management in the Menu and the Symbol bar sm_restore execute Activities Restore Start sm_search_lis Activities Rest
91. rface GUD 9 2 Error messages of the kernel software 9 2 1 BACKUP problems at backups 92 2 BASICS oca A eo a 9 2 3 BREAK unexpected break 9 2 4 CONFDRI Configuration drives 9 2 5 CONFLOA Configuration Loader 9 2 6 DATABAS Problems with the database 9 2 7 DBFPACK Database File Packer 9 2 8 DRIVES Problems with drives ere 9 2 10 LOADERS Problems with loaders fee ety ek tet At 9 2 12 RESTORE Restore problems 9 2 13 SBC_COM Messages of the Sesam Backup Client 9 2 14 SEPULER Messages of the SEP sesam Scheduler 9215 OTHERS 2 ee 2007 SEP AG 7 SEPsesam Version 3 0 SEP Global Storage Manogament CONTENTS 2007 SEP AG 8 SEPsesam Version 3 0 Chapter 1 Introduction 1 1 Storage Management Storage or data management is based on 5 main items Availability of data Security of data Backup of data Restore of data Disaster recovery The explicit destination of SEP AG is to integrate all 5 items into customer s storage concepts 1 1 1 Availability of Data The goal of every data management is the permanent availability of company relevant information In an environment where times to react decrease more and more a loss of data can cause severe and often very expensive problems The nowadays existing la
92. rge amounts of data demand a lot of time for maintenance and support which should be minimized by an optimal data management The user wants to get its data fast and always 1 1 2 Security of Data Using security techniques like encryption support of firewalls and secure shell prevent misuse and violation of data 1 1 3 Backup of Data Only a backup without interruption provides cover from loss of important data The installed systems should be easy to use and able to work in an environment of heterogeneous operation systems SEP Global Storage Manogament CHAPTER 1 INTRODUCTION 1 1 4 Restore of data During restore the data are copied from the backup media to the original source or new targets 1 1 5 Disaster Recovery In case of disaster recovery the totally lost data should be restored as guick as possible Fire damage assaults or natural disaster are examples that cause total loss of data 1 2 Objects of SEPsesam To make it easy to understand and configure the software an object oriented approach using following 6 basic components was chosen e Drive Drives are devices which write data on media They may be connected to SEPsesam host local drive or to other computers reachable over net remote drive Normally tape devices writing on removable tape cartridges are used DISK drives are a special thing because they are not real devices but are built by directories on disks e Loader Drives may be installed in
93. rver Module for oaisgl and sm db main ALL Trace settings for all modulesW SESS Session layer tracing RTP Encode decode tracing XM Memory AL Association RDA RDA protocol SUR Sequence rule AE Application entity PRESS Presentation layer CLI CLI layer SAO Reserved for ATI SACF Reserved for ATI RDAASE Reserved for ATI SQLS Database server layer only for local configuration SQLD Enable tracing in the Ips only for local configuration Setting Server Trace Flags The trace output for the Server is performed according to the selected Server module plus the corresponding trace level which is specified using a bit field Example Tracing for all mit bit field f ie FATAL SNO PARM ERRORS and tracing for Server module Session Layer with 1ff i e all messages TraceOptions all f sess 1ff Server Trace Flag Settings 2007 SEP AG 67 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 4 PROTOCOLS AND LISTINGS Flag Description Bit Mask MAX All tracing options set Ox1ff FATAL Fatal errors 0x001 SNO Should not happen conditions 0x002 PARM Invalid parameters 0x004 ERRORS General errors 0x008 MAJOR_EV Major network event 0x010 MINOR EV Minor network event 0x020 INFO Informational trace 0x040 F_TRACE Function trace 0x080 TRIVIA Trivial messages 0x100 TIMESTAMP Time stamp function calls 0x200 4 6 3 SMS
94. s NT services which control the JetDB Databases Warning for English German Versions the service names can differ Service name net start stop Description Database MSExchangeMTA message transfer agent mtadata MSExchangeES MSExchangelS information store mdbdata priv edb mdbdata pub edb MSExchangeDS directory service dsadata ds edb 8 3 3 Full Backup As Backup source the Exchange Server name should be selected In the GUI then should be selected Exchange Backup so that then sbc_msex is called Principle 2007 SEP AG 92 SEPsesam Version 3 0 SEP 8 3 ONLINE BACKUP EXCHANGE SERVER 5 5 Global Storage Management sbc_msex b S decunix 11001 s exchange sset j exchange d tmp QSWNT400 Example with sm_ctrlc sm_ctrlc l system p 11301 gswnt400 sbc_msex b C softnt10 S softnt10 1 full s SC20011022151425 d SMS disk1 t DISK00001 1 j exIS i ex_IS qswnt400 sbc_msex gswnt400 8 3 4 Information Store Backup As Backup source is selected the Exchange Server name and Submodule delimited with Slash Example sbc_msex b S decunix 11001 s exch_IS sset j exch_IS d tmp QSWNT4001 15 8 3 5 Full Restore Example sbc_msex r S decunix 11001 s exchange sset j exchange d tmp QSWNT400 In the GUI over corresponding selection in the Restore wizard 2007 SEP AG 93 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 8 SPECIAL MODULES 2007 SEP AG 94 SEPsesam Version 3 0 Chap
95. se The Start of an ORACLE7 Backup requires the sesam client Software sbc_ora7 ORACLE7 tasks can be started directly from the SEPsesam System Backup type SAP R3 As source of a SAP R3 Backup should be specified the SAP R3 ID of the SAP R3 database A SAP R3 task is started externally from the SAP R3 System with BRBACKINT br backup brarchive brrestore 2007 SEP AG 31 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM SEPsesam makes possible the execution of an external Backup Utility INFORMIX ONBAR ORACLE RMAN SAP R3 BRBACKINT with the help of a command event 3 3 The Programs of the Server 3 3 1 The Kernel programs Under ID bin sesam reside the Kernel programs sm_ exe of the SEPsesam Software The programs presented below can be called directly from the command line The programs which are not presented are contacted internally by those described here as subprogram calls A direct call is therefore not necessary The command syntax generally corresponds to the getopts Standard i e sm Switch Value Hint Improper usage of these commands can lead to severe functionality problems 3 3 1 1 sm backup Description sm backup controls the execution of a Backup task List of the sub functions GET_BACKUP_TYP GET_NODE_PARAMS GET_TASK_PARAMS CHECK_LICENSE CHECK_SEMAPHORES CHECK_MEDIUM gt sm_init in case no media available CHECK_PERMIT gt Alive
96. sers allow user command Examples a Access for user oracle program sm oracle client oracle sm_oracle_client b Access for user informix with any program informix The command execution is always performed with the selected user only su user Hint The login scripts of the user e g informix profile should not wait for interactive input e g Select the database with 1 or 2 Such waiting for input would block the command execution 5 5 3 Command restriction on WNT Systems For the restriction of SEPsesam command events the Registry entries under HKEY LOCAL MACHINE SOFTWARE SEP Elektronik GmbH sesam CommandEvents are used Each user maps to a folder the program to be executed to a key with any value Additional information for the command release can be specified as a key value 2007 SEP AG 74 SEPsesam Version 3 0 SEP 5 6 CONFIGURATION OF A FIREWALL Global Storage Management Hint The folder CommandEvents may be only supplied with the mandatory access rights in or der to avoid undesired access A command event can be executed only in case that the user as well as the name of the program to be executed are present If an is specified as a Program Key then any commands can be executed Special case command cmd In case a CMD command MS DOS command interpreter e g cmd c dir c is specified first the Registry key cmd is searched If it is not defined then t
97. sesam Program is called sometimes appears the following error message UNIX TRU64 sbin loader Fatal Error cannot map libsm so Linux error while loading shared libaries libsm so cannot load shared object file No such file or directory or some similar message 2007 SEP AG 18 SEPsesam Version 3 0 SEP 2 4 INSTALLATION ON WINDOWS Global Storage Management 2 4 Installation on Windows Operating system e Windows 2003 e Windows 2000 e Windows XP e Windows NT 4 0 from ServicePack 6 Hardware Requirements e Processor Intel AMD e Frequence from 500 MHz e Main memory from 128 MB A bigger memory is an advantage for the speed Software Requirements e Working name resolution correct DNS for IP name and IP address reverse lookup Hint If you want an installation over command call without interaction then an installation CD can be ordered at SEP AG where the installation files are stored as zip files With the command call sm setup in the directory of the zip files see and with access to an appropriate unzip tool On the CD there is unzip exe under utils it is possible to make the installation with a command call without further input This installation method is unusual under Windows so on the installation CD are stored 3 self extracting archives They contain an Installshield which offers for installation the SEPsesam programs contained in the archive e nt clif VersionNr exe Installation
98. setsource savesettarget argument 1015 E_ERROR Cannot get HOME directory 11016 E ERROR Cannot change directory to s s EXIT 1017 E_ERROR Backup command call failed with exit value hi 1018 E ERROR DATA interface start failed s 1019 E ERROR System call s timed out after i seconds EXIT 1020 E_ERROR Backup source not specified Exiting 1021 E ERROR Cannot read item header from archive s Exiting 11022 E ERROR Unknown item header magic number s Exiting 1023 E_ERROR Cannot read item header from archive 4s 4d d Pel 4s d d DIR fl fl fl fl hu bytes d CLI XBSA Exiting 1024 E_ERROR 1025 E_ERROR Exiting 1026 E_ERROR 1027 E_ERROR 1028 E_ERROR 1029 E_ERROR 1030 E_ERROR 1031 E_ERROR 1032 E_ERROR bytes 1033 E_ERROR 1034 E_ERROR 1035 E_ERROR 1036 E_ERROR 1037 E_ERROR 1038 E_ERROR 1039 E_ERROR Cannot parse item header 4s Exiting Cannot read item name from archive Cannot create temporary directory s Cannot read from remote archive s Termination signal received Failed to kill DATA process 4d s Archive padding failed s Cannot write to remote archive s Cannot read item s
99. slu mode sense Used to query the loader state resp to return the last error state Example 2007 SEP AG 59 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM sm_slu 360 s 1 x Transport First 1000 30 x Slot First 0 1 x Port First 1010 2 x Drive First 1030 3 7 4 sm_slu read element status With this option a list of all elements Slot Drive Transport Port and their filling is produced Example 1 sm slu 360 e full Slot O adr 0 src 1030 tape 1 1 full Slot 2 adr 2 src 4 tape 1 Slot 8 adr 8 src 1030 tape 1 Slot 9 adr 9 src 0 tape 1 Slot 10 adr 10 src 1031 tape 1 Slot 0 adr 1030 src 1 tape 1 Example 2 sm slu 360 e empty Slot 1 adr 1 src 0 tape 0 0 empty Slot 3 adr 3 src 0 tape 0 Slot 4 adr 4 src 0 tape 0 Slot 5 adr 5 src 0 tape 0 Slot 6 adr 6 src 0 tape 0 Slot 7 adr 7 src 0 tape 0 Slot 11 adr 11 src 0 tape 0 Transport 0 adr 1000 src 0 tape 0 Port 0 adr 1010 src 0 tape 0 Drive 1 adr 1031 src 0 tape 0 Example 3 sm slu 360 e s 0 s slot Slot O adr 0 src 1030 tape 1 Example 4 sm slu 360 e d 0 d drive Drive 0 adr 1030 src 1 tape 1 Example 5 sm slu 360 e p 0 p port Port 0 adr 1010 src 0 tape 0 2007 SEP AG 60 SEPsesam Version 3 0 SEP 3 7 SESAM LOADER UTILITY SLU Global Storage Manogament 3 7 5 sm_slu read element status with label This option produces a list with all elements Slot Drive
100. source specification 8 2 4 Full Restore Principle sbc r a r S decunix 11001 s sql sset d tmp SBCMSQL pubs In the GUI over corresponding selection in the Restore wizard Finally go with sqlmangr exe Enterprise Manager to the appropriate Location Database and for Backup Restore Database select the corresponding ComboBox first backup to restore 8 3 Online Backup Exchange Server 5 5 Hint The connection to Exchange Server 2000 is described in a separate document 8 3 1 System reguirements Reguirements at the Client e Exchange Server 5 5 2007 SEP AG 91 SEPsesam Version 3 0 SEP Global Storage Manogament CHAPTER 8 SPECIAL MODULES e Sesam NT Client e g 1 5 1 14 Additional modules bin sesam e edbbcli dll e sbc_msex exe e start_service bat Attention for English German Versions the service names can differ e stop _service bat sm ini modification examples PATHES gv_rw_smxb_log C sesam_client nt_cli 1 5 1 14 var log smxb The directory must be then created gv_rw_work C sesam_client nt_cli 1 5 1 14 var work gv _rw_tmp C sesam_client nt_cli 1 5 1 14 var tmp sm_node Settings for Sub Module sm ctrld main under services sm_node Start type Login as service account e g NTTEST Administrator Password so the system user may administer Exchange 8 3 2 Description EXCHANGE MS Exchange 5 5 can be installed on NT Domain Servers only MS Exchange consists of several Window
101. st be available On WNT there is only the Registry as a system database on Windows2000 the concept was extended and in the so called System State is stored all system relevant data active directories boot files registry etc In order to Backup the Registry resp System State in disaster Backup tasks must be specified as Backup source registry resp system_state eg SESAM REG and SESAM SYSTEM STATE These tasks should be executed regularly together with the Backup of the directories men tioned above Hint The disaster recovery was tested on the following Windows systems NT4 0 SP3 Workstation Windows 2000 SP3 Windows 2000 Server SP3 XP Professional Windows 2003 Server SP3 2007 SEP AG 84 SEPsesam Version 3 0 SEP 6 2 DISASTER RECOVERY UNDER WINDOWS Global Storage Management 6 2 1 Proceeding in disaster case Installation of the operating system The installation directory must be the same as the previous one Attention should be paid to the correct group assignment and network configuration The original Service Pack must be installed as well Installation of the SEPsesam Client Proceed according to README_INSTALL txt see 2 4 During the installation should be specified the server which had managed the disk and Registry Backup Restore of the Registry resp the System State 1 Boot the Windows 2000 2003 XP Rechner in Recovery mode therefore press the F8 key Not
102. t lt Port gt GUI Immediate start Backup Possible database errors ODBC sm_db_main Connection to database failed Possible SEPuler errors sepuler Backup will not be started Check over Schedules gt Events The event should disappear at the latest 1 minute after execution Possible Queue Manager errors Queue Manager Backup will not be started Check over Monitoring drives Check the process sm gm main and if necessary repeat sm startup SM commands for Backup Possible CTRLC SSH errors sm_ctrle Connection to the Client not possible Check the name resolution Name and Address Check if the Client is reachable Check if the Client is reachable over CTRLC SSH Check sm_ctrld at the Client if it is active at the right port Check sm ctrlc ssh connection from the command line 2007 SEP AG 70 SEPsesam Version 3 0 SEP 5 4 GUI SERVER ADMINISTRATION Global Storage Management Possible SBC errors Check the sbc component at the Client Possible STPD errors Check stpd at the server Check FTP errors in the Backup protocol 1 Check daemon and process list 2 Check FTP connection with ftp Host 11001 e g ftp A0032 11001 Possible SMS errors Check SMS Dataserver Check sms errors in the Backup protocol Check SMS Dataserver in the process list If necessary increase the log level and check the logging 5 4 GUl Server Administration For the ODBC access an ODBC Driver Manager as e g odbc32 Standa
103. t f1 d export COMPUTERNAME echo COMPUTERNAME COMPUTERNAME acroread in netscape pconfig alphaosf 2007 SEP AG 17 SEPsesam Version 3 0 SEP Global Storage Manogement CHAPTER 2 INSTALLATION adir usr local Acrobat3 NPX PLUGIN PATH adir Browsers pconfig export NPX PLUGIN PATH PATH PATH adir bin export PATH DELIMITER FOR damisql SEP export SEP some alias alias work cd sesam2000 work_dir dirname sesam2000 work alias cat info cat opt sesam var work info info dat alias cat status ls t opt sesam var prot status head 1 xargs cat alias cat_prot ls t opt sesam var prot prt head 1 xargs cat EXTENSION PSQL if type psql dev null 2 amp 1 then alias sql psql d sesam db p 11201 c else alias sql damisql d sesam_db q fi EXTENSION SET CDPATH CDPATH 8CDPATH opt sesam opt sesam var opt sesam var log opt se sa m var work opt sesam bin EXTENSION SET LD LIBRARY PATH LD LIBRARY PATH opt sesam bin sesam export LD LIBRARY PATH For the execution of Sesam Kern modules on UNIX the environment variable LD LIBARY PATH must be set to ID SEPsesam sesam bin directory See Example EXTENSION SET ODBCINI ODBCINI opt sesam bin sesam export ODBCINI If the Profile was not applied when a SEP
104. t the drive on which it will actually start While starting sm_backup it enters immediately the drive number in the table results 2007 SEP AG 46 SEPsesam Version 3 0 3 3 THE PROGRAMS OF THE SERVER SEP Global Storage Management 3 3 3 8 Processing in case the desired drive is blocked If a drive number was specified it will be skipped if the resource is blocked e g the drive is defective The Queue Manager selects instead another drive with the desired allocation Pool 3 3 3 9 Lock drives If a drive is defective it must be temporarily locked The function block is used here sm gm block lt queue name gt lt resource gt Example sm gm block loader1 3 Hint HH H blocks holding and pending jobs If resource is specified the corresponding executing Queue is blocked as well blocks drive 3 in the drive group loaderl The queues for drive groups are initialized and started again at drive configuration This happens upon configuration changes and at SEPsesam Startup 3 3 3 10 Monitoring drive group queues The function sho shows for a Multi Queue the attribute allocate resource and the state of all executing queues sm gm shol fulll name Example sm gm sho name loader1 gue name loaderl lt queue name gt job_limit 5 Entry Job_name Time Preferred Resource holding queue pending queue 32 oracle_P01 12 30 30 oracle CO1 12 30 executing gueue Resource 1 2 bfasco 2bnd 10
105. t m set in the waiting queue of the drive The drive can however have maximum 60 SMS Channels see 3 3 6 so the Queue manager activates immediately 60 Backups and the remaining are subsequently started when a channel is released If the start time window of the Backup is narrowly defined it can happen that at the end some Backups cannot reach execution at all which is signalled and protocoled by SEPsesam 2007 SEP AG 42 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management The Queue Manager consists of the programs ID bin sesam sm_qm_main exe and sm_qm exe sm gm mainf exel is the Queue Manager Server and is started as a background process Ser vice Daemon see 8 5 which waits for requests from the Queue Manager Client sm_qm exe and controls the Queues Syntax sm_qm The call has the Form sm gm request further arguments Request Arguments Description block Queuename Resource creates Queue with Resource a specific Executing Queue is selected delete Queuename removes the Queue init Queuename Resource creates Queue with Joblimit with Resources sev Joblimit eral Executing Queues can be specified sho Queuename all shows the Queue resp all Queues and their contents and states sho name Queuename all shows the Queue resp all Queues with job names sho full Queuename all shows the Queue resp all Queues with execution pa rameters start Queu
106. tate which avoids time consuming rewinds So it is absolutely necessary to control the drives of SEPsesam with this drive handler only In MOUNT it is generally possible to take a cassette out of a drive Problem SEPsesam works then possibly on the wrong media The drive information remains consistent only in case that before the unload of the cassette a Dismount was performed Return values on the STDOUT STATUS SUCCESS ERROR MSG Desired output Error message 3 3 1 3 sm info Front end Kernel program for the GUI Display of current messages Description Writes and reads messages in resp from the SEPsesam Online Information area Display of current messages 2007 SEP AG 33 SEPsesam Version 3 0 SEP Global Storage Management CHAPTER 3 THE PROGRAMS OF SEPSESAM Syntax sm info P S M C Drive number Text Read from the information area sm info P Drive number Write status message sm info S Drive number Text Write message sm info M Drive number Text Check and output the license sm info C 3 3 1 4 sm init Kernel program for the GUI Activities Immediate start Media event resp planned media event Description Initializes a media in a drive so that it is then ready for Backups At this point either a fixed label or a media pool can be specified If a pool is given the label is selected after the GET_OLDEST Strategy number of retries still cannot be initialized Loader proble
107. ter 9 Problem analysis and solution The following description has the purpose that errors can be recognized as soon and exactly as possible Here SEPsesam offers the following possibilities e diverse Protocols incl Email delivery e Daily protocol files translatable with a program from foreign languages in German to simplify the analysis e Logging mechanism with setable levels Especially in the scenario SEPsesam runs for weeks without a problem with high throughput and suddenly the throughput decreases or specific computers are no more backed up SEPsesam serves in most cases as a detector for hardware and or software technical defects or changes in the network of the operator Changed addresses wrongly connected backbone defective star connector etc For problems in the functional sequence of SEPsesam the following analysis sequence can be recommended 1 Check with sm_main status if all processes are running see 3 5 if necessary start again the missing process with sm_main reload 2 Daily protocol see 3 Specific protocols for Backups Restores see 4 3 4 Logging files see 4 6 9 1 Problems with the interface GUI Problems with the Java security settings are sometimes difficult to recognize because e g the GUI Client does not start but the configuration error is to be searched on the GUI Server 95 SEP Global Storage Management CHAPTER 9 PROBLEM ANALYSIS AND SO
108. terface inquire_status d Tapel For all functions from sm sms interface presented here there are also the parameters v n for tracing Default 0 no trace L LoginType Default SHARE For inquiries use INQUIRE for Restores is necessary EX CLUSIVE in State CHANGING_MEDIA is accepted EOM only and for Administrative purposes ADMIN is used 3 3 1 10 sm sms watch Kernel program for the control of media change and for the output of tape state in the GUI Info window Display current messages see 3 3 1 3 Description Monitors the drive state and takes over the control at media change Communicates in case of 2007 SEP AG 40 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management End Of Media EOM with SMS for transfer of the new tape label and with sm loader for the change of the media Syntax sm_sms_ watch Drive number Hint In case of a problem at tape change the corresponding sm_sms_watch Logging is helpful for the Problem analysis Hint At the start of a Backup resp Restore task a check is made if sm_sms_watch is running in the corresponding queue and it is started again if necessary see 3 3 3 3 If an sm_sms_watch process is already running then the subsequently started process exits Hint Without the sm sms watch process for the corresponding drive the approaching tape end will not be recognized The media change for the Backup resp Restore will not be
109. ters of SMS Hint This file is automatically tuned by the SEPsesam drive configuration program sm_config drives when the drive configuration changes GUI The configuration is also performed again at Startup and at SEPsesam day change SMS_Device Maximal_Number_0f_Devices 2 Device_Name_0 diski Device Name 1 dev nst0 SMS_Disk Directory opt sesam var ini SMS_Tape Tapemark Type O SETMARK Tapemark Type 1 FILEMARK Default Segment Size 1000 Tape Online Timeout 120 Max Retries Num 20 Retry Delay On 1106 1 Max Repeat On 1106 20 Repair TRUE ISMS Server Throughput_Interval 5 Alarm Interval 30 Maximal Number Of Parallel Streams 0 9 Maximal Number Of Parallel Streams 1 9 Bin Directory opt sesam bin sms Ctl_Directory opt sesam var work ctl SMS_Logging Log_Levels 0 123456 1 NO_LOG O ERROR 1 EMERGENCY 2 WARNING 3 NOTICE 4 INFO 6 TRACE Log_Levels 0 123 4 Log Size 256 Log Max Files 10 Log Details 0 1 2 Log_Directory opt sesam var log sms Perf_Directory opt sesam var work info 5 DEBUG 2007 SEP AG 50 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management The access to SMS Media Tapes Disks is performed with the STPD Service Daemon see 3 3 6 or with the sm sms interface program see 3 3 1 9 Loggings are written under the directory ID var log sms 3 3 6 Data transfer with SesamTransferProtocol STP The STPD STPDaemon ID b
110. test at the Client PRE gt PRE Interface CHECK SMS WATCH gt Performance and EOM Surveilance EXECUTE_BACKUP gt CTRLC gt SBC gt STPC gt STPD gt SMS POST gt POST Interface RESULT_ANALYSE 2007 SEP AG 32 SEPsesam Version 3 0 SEP 3 3 THE PROGRAMS OF THE SERVER Global Storage Management Switch Description Default j task Task name TEST_BACKUP l char Backup type C F D T C Copy Full Diff Incr m pool Media pool in which should be backed up Pre setting d drive sesam internal drive number 1 drive of the media pool T time Start time hh mm dd mm yyyy W time End time hh mm dd mm yyyy S tapeserver computer to whose drive should go the SEPsesam Server data p num Priority 1 s saveset Name of the saveset time stamp v num 0 1 2 3 verbose level 1 3 3 1 2 sm drive Kernel program for the so called Drive handler in GUI Components Drives Drive action Description Module for execution of all drive specific requests local and remote Syntax sm drive Function Drivenumber Label Function Description init initializes the media in the drive with Label info output Label and MOUNT State of the media mount sets the media in MOUNT State dismount clears the MOUNT State In MOUNT State at an info request the label is not read from the media which would re quire a rewind to the beginning of media but from the database MOUNT is therefore a pure software technical s
111. the following FTP command a file can be read from the inserted media Get saveset tape ID segment Number tape z B get SF123 4 0 4 In ID var ini stpd ini are specified the execution parameters of STPD STPD_Server STPD_PORT 11001 TCP IP Port STPD_MAX_CONNECTIONS 64 Bin_Directory C su bin sms Ctl_Directory d su var work ctl Work_Directory d su var work 2007 SEP AG 52 SEPsesam Version 3 0 SEP 3 4 COMMUNICATION SERVER CLIENT Global Storage Management ISTPD Thread STPD_BUFSIZE 4 DATA_TIMEOUT 900 AUTH_USERS sms PSL authorized user UPDATE_THROUGHPUT 30 STPD_ACCEPT TRUE STPD_ID THIS_IS_KEY STPD USER root TMP allows access without User check STPD_Logging Log_Levels 0 1 2 max 012 3 4 5 6 Log Details 0 1 2 Log Size 64 Log Max Files 10 Log_Directory d su var log sms STPD_Inquire InquireLog d su var work info ing log Inquire_Timeout 10 Hint The maximal number of SMS channels is limited to 64 i e for Backups maximum 60 SMS chan nels can be used The remaining 4 channels are needed for administrative purposes tape change etc Loggings are written under the directory ID var log sms 3 4 Communication Server Client The command execution at the Client is performed according to the configured access method GUI Additionally options e g s for Single Port Option can be configured see 5 6 The access methods for the SEPsesam proprietary CTRL and for the SecureShell SSH
112. the following command overview The output can differ from version to version Example Usage Scan 0 7 for loaders and tapes slu scan bus Inquiry slu lt ID dev gt I li Mode sense slu lt ID dev gt s Read element status slu lt ID dev gt Je sld p num num full empty Read element status with label slu lt ID dev gt 1 s d lp num num full empty Move medium slu lt ID dev gt m lt s dlp num gt lt s d p num gt Unload for tapes slu lt ID dev gt I lu Load for tapes slu lt ID dev gt 18 Rewind for tapes slu lt ID dev gt r Allow removable for tapes slu lt ID dev gt I la Prevent removable for tapes slu lt ID dev gt I lp Reset Semaphore File slu reset ID dev The particular options are described below 3 7 1 sm slu scan For the SEPsesam user is first helpful the command sm slu scan for determination of the Device ID SCSI ID Bus LUN Target The command lists all Device IDs of the connected loaders and drives The Device ID is taken in the configuration of SEPsesam for control of the loader The control of drives requires that the corresponding drive number can be transferred to the loader This assignment relative drive number must be specified at the configuration of the drive When the loader is not a compact device e g TZ887 but a loader with standalone drives the standalone drive must be explicitly opened for unload This unload is also performed with a slu command Here
113. to loaders which are able to move media from a magazine into drive and vice versa Thus fully automatic operation of the backup system during nights and weekends is possible e Client Clients are computers in net whose data have to be backed up e Media Media are removable data carrier where the copied data are stored for cases of data loss or damage e Task A task makes up a description of a backup or a restore Here data source target type of backup or restore etc are denoted e Appointment Time control of SEPsesam is performed through schedules i e all activities are entered into a central appointment calendar and a program the so called SEPuler which ensures that these appointments are executed at the right time 2007 SEP AG 10 SEPsesam Version 3 0 Chapter 2 Installation 2 1 Directory structure During unpacking the SEPsesam Software the following directory structure is created Installation Directory ID ID skel Template Files incl raw database for the first installation ID bin sesam Sesam Server components ID bin sms sms and stpd components ID bin gui Sesam Server Gui components GraphicalUserInterface ID bin db Sesam Server database components During Setup the following directory structure is created whereby the Installation directory ID must not correspond to the directory mentioned above ID var ini Initialization files ID var log
114. ts gt supportOsep de E005 SEPULER invalid command val gt supportOsep de E006 SEPULER Restoretask val not yet de fined please do it now nachholen gt repeat in the Restore wizard E007 SEPULER READ INI sent error val gt supportOsep de E008 SEPULER There are no drives attached to drive group val gt select other group or drive gt Change the configuration E009 SEPULER String overflow val gt val gt supportOsep de E010 SEPULER Wrong type of schedule cycle val gt select another type E011 SEPULER Error happend during calcula tion of user defined list for schedule val gt supportOsep de E012 SEPULER Calculating next execution for schedule val returns always the same timef val gt supportOsep de 9 2 15 OTHERS Error message Cause Solution E001 START Drive is not available val gt Correct the configuration E002 START Drive val does not exist val gt Correct the configuration Error message Cause Solution E001 STARTUP Directory val not found gt Problem after Installation gt Manually create the directory Error message Cause Solution E001 WATCH Received performance data with invalid format val SMS Server is not running gt sm_main reload sms This message may appear temporarily E002 WATCH EOM finished with error val gt
Download Pdf Manuals
Related Search
Related Contents
その8(306KB) UPSV User Manual - Stanley Hydraulic Tools Vienna Acoustics Subson User's Manual Lenco DC-1041 digital camera GDS 820 Cables Direct B6ST-710 networking cable Princess Churros Cake Maker Sys[em S。ーuti。n Programme Formation 2012 Guía de instalación del servidor Netra T2000 Copyright © All rights reserved.
Failed to retrieve file