The following instructions assume that Windows NT or Windows 95 is already running on the client workstation. To install the Windows NT or Windows 95 client portion of ADSM, do the following:
You can run setup.exe from the \ADSMCLI\WIN32\INTEL directory on the CD-ROM for single byte languages or from the \ADSMCLI\WIN32\MBCS directory for multibyte languages, or you can enter dsmv3w32 after you download the dsmv3w32.exe file (18 MB) to a temporary directory on a hard drive containing a minimum of 30 MB of free disk space.
If you search for previous installations and an ADSM directory is located, select one of the following:
| Note: | Back up any files you want to retain before you install the client. Existing dsm.opt files are preserved and the new sample options file is copied to dsm.new. |
Select the clients you want to install. Install support files for your communication method, if support files are required.
| Note: | You must install the client scheduler if you want to use the automated features of ADSM. |
If you select both the backup-archive client and the administrator client, you can install both clients into a single directory or separate directories. If you install into a single directory, the clients share an options file. Clients installed into a single directory must be uninstalled at the same time; you cannot independently uninstall the backup-archive client or the administrator client, unless they are in separate directories.
To use a different directory, click on Browse. Enter the location in the box labeled Path and click on OK.
| Note: | The directory name you select cannot contain a blank character. |
The amount of disk space required for the installation options you chose and the amount of space you have available appear at the bottom of the window. Make sure there is enough disk space for the ADSM client files on the destination drive. The installation program will not allow installation to a destination drive with insufficient disk space.
For more information on using the ODBC driver and the Administrative client, see ADSTAR Distributed Storage Manager for Windows NT Adiministrator's Guide, GC35-0292.
The installation process creates a program group. The contents of the program group depends on the client components you chose to install. This program group allows easy access and running of the ADSM client within the Windows environment.
If there are other ADSM clients installed on the same system, caution should be taken when you switch from one client to another because environment variables such as DSM_DIR can be shared by more than one client of different platforms (such as DOS and Windows).
The options you selected in the Client Setup-Option window determine
which files are copied into the directory you specified. Figure 36 lists the files that are copied if you select all of the options.
| File Name | Description |
|---|---|
| adsm.ok | Signal file -- install completed successfully |
| adsmv3.dll | ADSM 32-Bit Windows API |
| baclient.txt | Backup-Archive client readme file |
| bacln6c.ico | Backup-Archive command line client icon |
| ba_dsm.opt | Backup/Archive client sample options file |
| blkhook.dll | API DLL used by some utilities |
| client.ico | Backup client icon |
| clntopt.ico | Backup client options icon |
| ctl3d32.dll | Microsoft 3D controls DLL |
| customc.ini | Controls initial display of user-specified readme file |
| DeIsL1.isu | Uninstall log file -- do not touch |
| dsc30xxx.dll | Language specific resources and strings, where xxx is the language selected, ie. enu for English |
| dschxxx.hlp | Language specific help, where xxx is the language selected, ie. enu for English |
| dschxxx.cnt | Language specific help contents, where xxx is the language selected, ie. enu for English |
| dscameng.txt | NLS message repository |
| dsm.cnt | Backup-Archive GUI help contents |
| dsm.dll | Backup-Archive GUI resource DLL |
| dsm.exe | Executable file for the backup-archive GUI client |
| dsm.hlp | Backup-Archive GUI help |
| dsm.ico | GUI client icon |
| dsm.opt | Sample client options file (dsm.new if prior dsm.opt file existed) |
| dsmc.exe | Executable file for the backup-archive command line scheduler client |
| dsmc.hlp | Help file for the command-line client |
| dsmcsvc.exe | Scheduler service client |
| dsmcsvci.txt | Scheduler service installation utility readme file |
| dsmcutil.exe | Scheduler service installation utility |
| dsmgetst.hlp | Getting Started help |
| dsmgsw01.avi | Getting Started multimedia file |
| dsmgsw02.avi | Getting Started multimedia file |
| dsmgsw03.avi | Getting Started multimedia file |
| dsmgsw04.avi | Getting Started multimedia file |
| dsmutil.dll | Scheduler service install utility resources |
| dsws.ico | Scheduler icon |
| inetwh16.dll |
|
| inetwh32.dll |
|
| mfc42.dll | Run time dynamic link library |
| mfco30.dll | Run time dynamic link library |
| msvcrt.dll | Shared DLL version of C Run-Time library |
| msvcrt40.dll | Run time dynamic link library |
| ntcons.exe | Alternate tracing console |
| Olepro32.dll | OLE 32 bit resource DLL |
| options.wri | Information about all options available |
| packing.lst | Client file list |
| qref.ico | Quick reference icon |
| readmec.cnt | Readme help contents file |
| readmec.GID | Readme help Windows system ID file |
| readmec.hlp | Readme help file |
| readme.1st | Last minute updates and other special information |
| sa_dsm.opt | Administrator client sample options file |
| start.ico | Getting started icon |
| uninstal.exe | InstallSheild uninstall program |
| yourfile.txt | Sample user-specified readme file |
If you install the Administrative client, the Backup-Archive client and the
Administrative client files should reside in the same directory, unless
separate directories were specified during installation.Figure 37 lists the Administrat client files.
Figure 37. ADSM Administrator Client Files
| File Name | Description |
|---|---|
| adcln6c.ico | Command line Administrative Client icon |
| admin.ico | Administrative Client GUI icon |
| adminopt.ico | Administrative Client options file editing icon |
| dscameng.txt | NLS message repository |
| dsg30xxx.dll | Language specific resources and strings, where xxx is the language selected, ie. enu for English |
| dsghxxx.hlp | Language specific help, where xxx is the language selected, ie. enu for English |
| dsghxxx.cnt | Language specific help contents, where xxx is the language selected, ie. enu for English |
| dsm.opt | Sample client options file (dsm.new if prior dsm.opt file existed) |
| dsmadm.exe | Executable file for the Administrative Client GUI |
| dsmadmc.exe | Command line Administrative Client |
| saclient.txt | Administrative Client readme |
| DeIsL1.isu | Uninstall log file -- do not touch |
If you install the Application Programming Interface (API), the directory
api is created in the win32app directory. The API
files are copied into a set of directories in the api
directory. Figure 38 lists the API files and the directories in which they
reside.
| File Name | Description |
|---|---|
| BIN | -- Binary directory |
| dapismp.exe | Sample program |
| adsm32.dll | The ADSM API library for Windows NT and Windows 95 |
| dscameng.txt | Message repository |
| BLKHOOK | -- Blocking Hook code directory |
| blkhook.c | Sample blocking hook function |
| blkhook.def | Module definitions with exports for blkhook.dll |
| blkhook.mak | Makefile to make blkhook.dll |
| dapismp.mak | Makefile for sample application dapismp.exe |
| dapismp.vc |
|
| DLL | -- Dynamic Link Libraries directory |
| adsm32.dll | ADSM 32-bit Windows DLL for Windows NT and Windows 95 |
| blkhook.dll | Blocking Hook user exit DLL |
| INCLUDE | -- Header files directory |
dapidata.h dapint64.h dapitype.h dapiutil.h dsmapidl.h dsmapifp.h dsmapitd.h dsmcrypt.h dsmint64.h dsmping.h dsmrc.h | Sample program C header files |
| LIB | -- Implicit libraries directory |
| adsm32.def | Implicit library for adsm32.def |
| adsm32.lib | Implicit library for adsm32.dll |
| adsm32vc.exp | Implicit library for adsm32vc.exp |
| adsm32vc.lib | Implicit library for adsm32vc.lib |
| blkhook.lib | Implicit library for blkhook.dll |
| OBJ | -- Object code directory |
blkhook.map blkhook.obj dapibkup.obj dapiinit.obj dapint64.obj dapipref.obj dapiproc.obj dapipw.obj dapiqry.obj dapirc.obj dapismp.map dapismp.obj dapiutil.obj | Sample program object code files |
| SAMPRUN | -- Sample program directory |
adsm32.dll blkhook.dll dapismp.exe dscameng.txt | Sample program files |
| SAMPSRC | -- Source code directory |
| dapismp.mak | Makefile to make dapismp.exe |
dapibkup.c dapiinit.c dapint64.c dapipref.c dapiproc.c dapipw.c dapiqry.c dapirc.c dapismp.c dapismp.vc dapiutil.c dynaload.c register.frm | Sample program source code |
If you install the ODBC driver, the directory odbc is created in
the win32app directory. The ODBC driver files are copied
into a set of directories in the api directory. Figure 39 lists the ODBC driver files and the directories in which they reside.
Figure 39. ADSM ODBC Driver Files
| File Name | Description |
|---|---|
| _odinst.ini | ADSM ODBC driver and setup routines |
| Unodbc.dll | ADSM ODBC readme file |
| DeIsL1.isu | Unistall log file - do not touch |
| ADSM | -- ODBC ADSM files directory |
| dsgameng.txt | ADSM ODBC messages |
| odbcadsm.dll | ADSM ODBC driver and setup routines |
| odbcadsm.txt | ADSM ODBC readme file |
| MANAGER | -- ODBC manager base files directory |
| ds16gt.dll | ODBC driver setup generic thunk 16 bit dll |
| ds32gt.dll | ODBC driver setup generic thunk 32 bit dll |
| odbc16gt.dll | ODBC generic thunk 16 bit dll |
| odbc32.dll | ODBC driver manager routines |
| odbc32gt.dll | ODBC generic thunk 32 bit dll |
| odbcad32.exe | ODBC Administrator (manager function) |
| odbccp32.cpl | ODBC installer |
| odbccp32.dll | ODBC installer |
| odbccr32.dll | ODBC cursor library |
| odbcinst.cnt | ODBC installer help contents |
| odbcinst.hlp | ODBC installer help |
| odbcint.dll | ODBC language library |
Figure 40 lists the WebShell files and the directories in which they reside.
Figure 40. ADSM WebShell Client Interface Files
| File Name | Description |
|---|---|
| BACLIENT | -- Backup Client directory |
| adsmpswd.exe | Used to create/update adsmpswd.ws (ADSM password file) |
| mkwspswd.exe | Used to create/update adsmweb.ws (WebShell Web authentication file) |
| webshell.exe | WebShell client |
| webshell.txt | WebShell client readme |
| BACLIENT\WSSTUFF | -- WebShell support files directory |
| adsmhbk.html | Backup help |
| adsmhbs.html | Backup selection help |
| adsmhead.gif | WebShell masthead |
| adsmhelp.gif | Graphic for the ADSM WebShell help banner |
| adsmhrs.html | Restore selection help |
| adsmhrst.html | Restore help |
| adsmhsta.html | File system selection help |
| adsmpswd.ws | Web authentication file |
| adsmresp.ws | File used by WebShell to end response prompting by the ADSM server |
| backgrou.gif | Graphic for the background |
| backup.gif | Graphic for the backup to safe image displayed on the backup form |
| blank.gif | Graphic for small space filler |
| info.gif | Graphic for the ADSM WebShell help icon |
| rbspace.gif | Graphic for larger space filler |
| restore.gif | Graphic for the safe to restore image displayed on the restore form |
| wsreadme.html | WebShell online documentation |
To reinstall the ADSM client, we recommend that you use the installation CD-ROM to install any files (the files on the installation CD-ROM are in compressed format).
Start the reinstallation the same way you started the first installation (see "Installing the Client Program (Required)" for instructions).
| Note: | Back up any files you want to retain before you reinstall the client. Existing dsm.opt files are preserved and the new sample options file is copied to dsm.new. |
If you install the ADSM client files in a different directory than the one where you previously installed them, you might want to delete the previously installed files to save disk space.