1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
|
<HTML>
<HEAD>
<TITLE></TITLE>
<LINK REL="ToC" HREF="httoc.htm">
<LINK REL="Index" HREF="htindex.htm">
<LINK REL="Next" HREF="aguide04.htm">
<LINK REL="Previous" HREF="aguide02.htm"></HEAD>
<BODY BGCOLOR="#FFFFFF">
<P ALIGN=CENTER>
<A HREF="aguide02.htm" TARGET="_self"><IMG SRC="gaguide/graprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"></A>
<A HREF="httoc.htm" TARGET="_self"><IMG SRC="gaguide/gratop.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="TOC"></A>
<A HREF="htindex.htm" TARGET="_self"><IMG SRC="gaguide/graindex.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Index"></A>
<A HREF="aguide04.htm" TARGET="_self"><IMG SRC="gaguide/granext.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Next Page"></A>
<A NAME="E9E3"></A>
<H1>
<FONT FACE="Arial"><B><I>BASIC ADMINISTRATIVE TASKS</I></B></FONT></H1>
<BR>
<BLOCKQUOTE>
<P><I>This chapter covers the basic SOLID </I><I>Server </I>administrative tasks. It tells you how to:
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>install SOLID <I>Server</I>
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>start SOLID <I>Server</I>
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>create a new database
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>connect to the server using SOLID <I>Remote Control</I> or SOLID <I>SQL Editor</I>
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>shut down SOLID <I>Server </I>using SOLID <I>Remote Control</I> or from the server computer console
</BLOCKQUOTE></UL>
<A NAME="E10E4"></A>
<P>
<FONT FACE="Arial"><B>Installing SOLID </B><B><I>Server</I></B><A NAME="I2"></A></FONT>
<BLOCKQUOTE>
<P>If you have not yet installed SOLID <I>Server</I><A NAME="I3"></A>, follow these quick-start instructions, or refer to the <B>Read Me First</B> notice delivered with the product diskettes for a detailed description of the installation.
</BLOCKQUOTE>
<BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B>To Install Your SOLID </B><B><I>Server</I></B></FONT></H4>
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>Insert the SOLID <I>Server</I> diskette into your computer.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Run the program setup from the diskette.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Follow the instructions in the setup program.
</BLOCKQUOTE></UL>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>For installation instructions for Novell Netware, UNIX, VAX/VMS and Open VMS operating systems, refer to the <B>Read Me First</B> notice.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<A NAME="E10E5"></A>
<P>
<FONT FACE="Arial"><B>Installing Solid Drivers</B></FONT>
<BLOCKQUOTE>
<P>Some environments include SOLID <I>Server </I>drivers (ODBC, UNIFACE) on a separate diskette. To install the drivers:
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>To install the ODBC Driver, run the program setup from the ODBC Driver diskette.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>For instructions on installing other drivers read the readme.txt file on the driver diskette.
</BLOCKQUOTE></UL>
<A NAME="E10E6"></A>
<P>
<FONT FACE="Arial"><B>Starting SOLID </B><B><I>Server</I></B><A NAME="I4"></A></FONT>
<TABLE >
<TR>
<TD WIDTH=80 VALIGN=top >
<A NAME="E7E6"></A>
<P>
<IMG SRC="gaguide/aguide04.gif" WIDTH = 70 HEIGHT = 58 ALT="Undisplayed Graphic">
</TD><TD WIDTH=453 VALIGN=top >
<BLOCKQUOTE>
<P>You start SOLID <I>Server </I>by clicking the icon labeled SOLID Server in the SOLID <I>Server</I> program group.</TD></TR></BLOCKQUOTE></TABLE><BLOCKQUOTE>
<P><I>When SOLID </I><I>Server</I> is started<A NAME="I5"></A><A NAME="I6"></A>, it checks if a database already exists in the SOLID directory, that is, the directory where you installed SOLID executables. If a database file is found, SOLID <I>Server</I> will automatically open that database. If not, which is the case when you start the server for the first time, a new database will be created.
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>On UNIX operating systems <A NAME="I7"></A>, you start the server by entering the command solid at the command prompt. When you start the server for the first time, enter the command solid -f at the command prompt to force the server to run in the foreground.
<BR>On Novell Netware, you start the server by entering the command load solid.nlm at the command prompt.
<BR>On Open VMS, you start the server by entering the command run solid at the command prompt
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<A NAME="E10E7"></A>
<P>
<FONT FACE="Arial"><B>Creating a New Database</B><A NAME="I8"></A></FONT>
<TABLE >
<TR>
<TD WIDTH=146 ALIGN=center VALIGN=top >
<P><A NAME="I9"></A>
<IMG SRC="gaguide/aguide06.gif" WIDTH = 163 HEIGHT = 65 ALT="Undisplayed Graphic">
<P><I>Dialog 1. Username and </I><I>password entry.</I>
</TD><TD WIDTH=453 VALIGN=top >
<BLOCKQUOTE>
<P>If a database does not exist, SOLID <I>Server</I> will automatically start creating a new database. In the Windows environment, creating the database begins with <I>Dialog 1</I> prompting for the database administrator's username and password.</TD></TR></BLOCKQUOTE></TABLE><BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B>To Create a New Database</B></FONT></H4>
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>Enter the database administrator's username and password<A NAME="I10"></A> in the appropriate text boxes. The password will be displayed as asterisks.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Press the OK button.
</BLOCKQUOTE></UL>
<BLOCKQUOTE>
<P>The username<A NAME="I11"></A> and password<A NAME="I12"></A> are case insensitive. The username must have at least two characters; the password at least three. You can use lower case letters from a to z, upper case letters from A to Z and the underscore character ‘_’, and numbers from 0 to 9.
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>NOTE. You must remember your username and password to be able to connect to SOLID <I>Server</I>. There are no default usernames<A NAME="I13"></A>; the username you enter when creating the database is the only username available for connecting to the new database.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<TABLE >
<TR>
<TD WIDTH=146 VALIGN=top >
<P>
<IMG SRC="gaguide/aguide07.gif" WIDTH = 141 HEIGHT = 51 ALT="Undisplayed Graphic">
<P><I>Dialog 2. Creating a new </I><I>database.</I>
</TD><TD WIDTH=453 VALIGN=top >
<BLOCKQUOTE>
<P>After accepting the database administrator's username and password, SOLID <I>Server</I> will create a new database. By default the database will be created as one file (solid.db) into the SOLID directory, where the executables are located. This is indicated by <I>Dialog 2</I>. The time that the database creation process takes depends on the hardware platform you are using.</TD></TR></BLOCKQUOTE></TABLE>
<BLOCKQUOTE>
<P>After the database has been created, SOLID <I>Server</I> starts listening to the network for client connection requests. In the Windows environment, you will see a SOLID <I>Server</I> icon, but in most environments SOLID <I>Server</I> will run invisibly in the background as a daemon process.
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>NOTE. Create immediately a backup of your database to be able to use the log files to perform a roll-forward recovery.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>In OS/2, UNIX, Novell Netware, VAX/VMS and Open VMS operating systems<A NAME="I14"></A>, if you do not have an existing database, the following message appears:
<BR>Database does not exist. Do you want to create a new database (y/n)?
<BR>Answer y(es), and SOLID <I>Server</I> will prompt for the database administrator's username and password. When they have been accepted, a new database will be created.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>NOTE. If in the Windows environment you double-click the icon of a running SOLID <I>Server</I>, nothing will happen. SOLID <I>Server</I> is a background process that only reacts to messages from clients through the communication interface.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<A NAME="E10E8"></A>
<P>
<FONT FACE="Arial"><B>Connecting to SOLID </B><B><I>Server</I></B><A NAME="I15"></A></FONT>
<BLOCKQUOTE>
<P>After starting your SOLID <I>Server</I><A NAME="I16"></A>, you can test the configuration by connecting to the server<A NAME="I17"></A>. You can connect to the server from your workstation by using either SOLID <I>Remote Control</I> or SOLID <I>SQL Editor</I>.
</BLOCKQUOTE>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>NOTE. You need to have the privileges of SYS_ADMIN_ROLE or SYS_CONSOLE_ROLE to be able to connect to a server using SOLID <I>Remote </I><I>Control</I>.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<P>
<FONT FACE="Arial"><A NAME="I18"></A><A NAME="I19"></A><A NAME="I20"></A><A NAME="I21"></A><A NAME="I22"></A><A NAME="I23"></A><A NAME="I24"></A><A NAME="I25"></A><A NAME="I26"></A><A NAME="I27"></A><A NAME="I28"></A><A NAME="I29"></A><A NAME="I30"></A><A NAME="I31"></A><A NAME="I32"></A><A NAME="I33"></A><A NAME="I34"></A><A NAME="I35"></A><A NAME="I36"></A><A NAME="I37"></A><A NAME="I38"></A><A NAME="I39"></A><A NAME="I40"></A><A NAME="I41"></A><A NAME="I42"></A>Connecting with SOLID<I> Remote Control</I><A NAME="I43"></A></FONT>
<BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B>To Start SOLID </B><B><I>Remote Contro</I></B><A NAME="I44"></A><B><I>l</I></B></FONT></H4>
</BLOCKQUOTE>
<TABLE >
<TR>
<TD WIDTH=100 VALIGN=top >
<P>
<IMG SRC="gaguide/aguide08.gif" WIDTH = 32 HEIGHT = 32 ALT="Undisplayed Graphic">
<P><I>SOLID</I> Remote<BR>
<I>Control Icon</I>
</TD><TD WIDTH=600 VALIGN=top >
<UL>
<BLOCKQUOTE>
<LI>Start SOLID <I>Remote Control</I> by clicking its icon.
You will see SOLID <I>Remote Control’s</I> desktop and the dialog Server definition. In the Server definition dialog you will see a server named DEFAULT.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Click the DEFAULT icon or press the Connect button on the dialog box.
<BR>A logon dialog box will open.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Enter the username and the password you entered in the appropriate text boxes when you created the new database.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Press OK.
</BLOCKQUOTE>
<BR>After a while, you will see the server STATUS page opening. A connection to the server has been established.</TD></TR></BLOCKQUOTE></UL></TABLE>
<H4>
<FONT FACE="Arial"><B>To Disconnect from the Server</B></FONT></H4>
<BLOCKQUOTE>
<P>Close the window or choose Exit form the File menu.
<P>Refer to on-line help for detailed instructions on using SOLID <I>Remote </I><I>Control.</I>
<HR ALIGN=CENTER>
<P>On OS/2, UNIX, VAX/VMS, Open VMS and Novell Netware platforms you use the SOLID <I>Remote Control</I> (Teletype) program<A NAME="I45"></A> to test the configuration. See the chapter<I> Using SOLID Database Tools</I> for detailed information.
<HR ALIGN=CENTER>
<P>
<FONT FACE="Arial"><A NAME="I46"></A><A NAME="I47"></A><A NAME="I48"></A><A NAME="I49"></A><A NAME="I50"></A><A NAME="I51"></A><A NAME="I52"></A><A NAME="I53"></A><A NAME="I54"></A><A NAME="I55"></A><A NAME="I56"></A><A NAME="I57"></A><A NAME="I58"></A><A NAME="I59"></A><A NAME="I60"></A><A NAME="I61"></A><A NAME="I62"></A><A NAME="I63"></A><A NAME="I64"></A><A NAME="I65"></A><A NAME="I66"></A><A NAME="I67"></A><A NAME="I68"></A><A NAME="I69"></A><A NAME="I70"></A>Connecting with SOLID <I>SQL Editor</I><A NAME="I71"></A></FONT>
<H4>
<FONT FACE="Arial"><B>To Start SOLID </B><B><I>SQL Editor</I></B><A NAME="I72"></A></FONT></H4>
<TABLE >
<TR>
<TD WIDTH=100 VALIGN=top >
<P>
<IMG SRC="gaguide/aguide09.gif" WIDTH = 32 HEIGHT = 32 ALT="Undisplayed Graphic">
<P><I>SOLID</I> SQL Editor Icon
<A NAME="E7E7"></A>
<P>
<IMG SRC="gaguide/aguide10.gif" WIDTH = 29 HEIGHT = 27 ALT="Undisplayed Graphic">
<P><I>Connect button</I>
<P>
<IMG SRC="gaguide/aguide11.gif" WIDTH = 135 HEIGHT = 53 ALT="Undisplayed Graphic">
<P><I>Dialog 3. Logon dialog </I><I>box.</I>
</TD><TD WIDTH=600 VALIGN=top >
<UL>
<BLOCKQUOTE>
<LI>Start SOLID <I>SQL Editor</I><A NAME="I73"></A> by clicking its icon.
<BR>Click the Connect button. The logon dialog box appears on the top of the SOLID <I>SQL Editor's</I> document window. The dialog box shows the default server name you will connect to. You may change this name if you want to connect to another SOLID<I> Server</I>. The default Server name can be changed permanently by editing DSN parameter in [SQL Editor] section in the configuration file solid.ini.
<BR>
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Enter your username and password into the appropriate fields, and press the OK button to continue.
<BR>The password will be displayed as asterisks. The message bar in the lower left corner of the document window will confirm that the connection is established.</TD></TR></BLOCKQUOTE></UL></TABLE>
<BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B><I>To Execute</I></B><A NAME="I74"></A><B><I> a Predefined Query</I></B><A NAME="I75"></A></FONT></H4>
</BLOCKQUOTE>
<A NAME="E7E8"></A>
<P>
<TABLE >
<TR>
<TD WIDTH=100 VALIGN=top >
<IMG SRC="gaguide/aguide12.gif" WIDTH = 143 HEIGHT = 22 ALT="Undisplayed Graphic">
<P><I>Executing a predefined </I><I>datadictionary query</I>
</TD><TD WIDTH=600 VALIGN=top >
<UL>
<BLOCKQUOTE>
<LI>Select a predefined data dictionary query from the list box on the toolbar, and press the button located directly left of the list box.
<BR>The results of the query will be shown in the lower part of the window.</TD></TR></BLOCKQUOTE></UL></TABLE><BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B><I>To Load and Execute</I></B><A NAME="I76"></A><B><I> an SQL script</I></B><A NAME="I77"></A></FONT></H4>
</BLOCKQUOTE>
<TABLE >
<TR>
<TD WIDTH=100 VALIGN=top >
<A NAME="E7E9"></A>
<P>
<IMG SRC="gaguide/aguide13.gif" WIDTH = 30 HEIGHT = 32 ALT="Undisplayed Graphic">
<P><I>SQL button to execute </I><I>current statement</I>
<A NAME="E7E10"></A>
<P>
<IMG SRC="gaguide/aguide14.gif" WIDTH = 30 HEIGHT = 28 ALT="Undisplayed Graphic">
<P><I>SQL button to execute all </I><I>SQL statements</I>
</TD><TD WIDTH=600 VALIGN=top >
<UL>
<BLOCKQUOTE>
<LI>Press the open file button on the left side of the toolbar.
<BR>The Open file dialog will appear.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Select a sample SQL script to be loaded, and press OK button to continue.
<BR>The script will be loaded to the SOLID <I>SQL Editor's</I> document window.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Press the SQL buttons on the toolbar to execute current or all SQL statements of the loaded script.</TD></TR></BLOCKQUOTE></UL></TABLE>
<BLOCKQUOTE>
<P><I>Refer to on-line help for detailed instructions on SOLID </I><I>SQL Editor.</I>
</BLOCKQUOTE>
<A NAME="E10E9"></A>
<P>
<FONT FACE="Arial"><B>Viewing the SOLID </B><B><I>Server </I></B><B>Message Log</B><A NAME="I78"></A></FONT>
<BLOCKQUOTE>
<P>SOLID <I>Server </I>writes all error and info messages to a text file. This message log file is named solmsg.out and it is located in the SOLID directory. You can view this file using any text editor or file viewer. The error messages and their explanations are listed in <I>Appendix A SOLID Server Error Messages </I> of this document and in electronic format as the <B><I>SOLID Server Error Messages</I></B><B> </B><B>Help</B>.
</BLOCKQUOTE>
<A NAME="E10E10"></A>
<P>
<FONT FACE="Arial"><B>Shutting Down SOLID </B><B><I>Server</I></B><A NAME="I79"></A></FONT>
<BLOCKQUOTE>
<P>You can shut down SOLID <I>Server</I><A NAME="I80"></A><A NAME="I81"></A> either by
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>using the SOLID <I>Remote Control</I> program
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>using the SOLID <I>Remote Control</I> (Teletype) program
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>clicking the server icon and selecting Close from the menu appearing in the Windows environment
</BLOCKQUOTE></UL>
<BLOCKQUOTE>
<P>All the shutdown mechanisms will start the same routine, which writes all buffered data to the database file, frees cache memory and finally terminates the server program. Shutting down a server may take a while since the server must write all buffered data from main memory to the disk.
</BLOCKQUOTE>
<BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B>To Shut Down the Server Using SOLID </B><B><I>Remote Control</I></B></FONT></H4>
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>Connect to the server you want to close.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Go to the USERS page.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Press the Drop All... button.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Answer Yes the question Do you want to disconnect all users? This will throw out all users expect you from the database.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Go to the STATUS page.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>Press the Shut down... button.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>To the question Do you want to shut down the server?, answer Yes.
</BLOCKQUOTE></UL>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>NOTE. You need to drop all users to enable the shutdown process.
<HR ALIGN=CENTER>
</BLOCKQUOTE>
<BLOCKQUOTE>
<H4>
<FONT FACE="Arial"><B>To Shut Down the Server from the Server Computer in the Windows </B><B>Operating System</B></FONT></H4>
</BLOCKQUOTE>
<UL>
<BLOCKQUOTE>
<LI>Click the Server icon and select Close from the menu that appears.
</BLOCKQUOTE>
<BLOCKQUOTE>
<LI>If there are users connected to the server, choose OK in the appearing dialog box to continue the shutdown process. If there are no users connected to the server, the shutdown process is started immediately and a shutdown message is displayed.
</BLOCKQUOTE></UL>
<BLOCKQUOTE>
<HR ALIGN=CENTER>
<P>On OS/2, UNIX, VAX/VMS, Open VMS and Novell Netware use the SOLID <I>Remote Control</I> (Teletype) program<A NAME="I82"></A> to shut down the server. See the chapter<I> Using SOLID Database Tools </I> for detailed information.
<HR ALIGN=CENTER>
</BLOCKQUOTE><P ALIGN=CENTER>
<A HREF="aguide02.htm" TARGET="_self"><IMG SRC="gaguide/graprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"></A>
<A HREF="httoc.htm" TARGET="_self"><IMG SRC="gaguide/gratop.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="TOC"></A>
<A HREF="htindex.htm" TARGET="_self"><IMG SRC="gaguide/graindex.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Index"></A>
<A HREF="aguide04.htm" TARGET="_self"><IMG SRC="gaguide/granext.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Next Page"></A>
<center><p><font SIZE=-2>Copyright © 1992-1997 Solid Information Technology Ltd All rights reserved.</font></p></center></BODY></HTML>
|
