MultiBase and Cosmos. Particularities about the database engine installation on client-server architecture. BASE 100, S.A.

Transcription

1 Particularities about the database engine installation on client-server architecture BASE 100, S.A.

2 Index 1. CLIENT-SERVER INSTALLATION SERVER SIDE COMPUTER Linux or Unix Windows CLIENT SIDE COMPUTER ANNEX I. THE INETD PROCESS TO INVOKE THE DATABASE ENGINE IN SOME LINUX VERSIONS VARIATIONS TO THIS CONFIGURATION ANNEX II. PROFILE OF THE STARTING SERVICE USER ANNEX III. ACTIVATION OF SECURITY POLICIES DOMAIN SERVERS Policies for domain servers SERVERS WITHOUT DOMAIN Policies for servers without domain ANNEX IV. ACTIVATION OF THE CTSQL SERVICE IN WINDOWS SERVERS CTSQLMONITOR Copyright BASE 100, S.A. All rights reserved. All products mentioned in this document are trademark or registered trademark of their respective owners. [NT_client-server_v3_en.doc] Pág. 2

3 1. Client-server installation When installing your License in client-server mode you should take into account the peculiarities discussed bellow. IMPORTANT: If you are using a firewall, you must open the port defined in the "services" file for the clientserver connection. Note that some antivirus software installs a firewall software. 1.1 Server side computer Linux or Unix The services file ( /etc/services ) must be modified. This file is placed in the "/etc" directory. In that file you must define the name of the database engine ("CTSQL", for example), with the associated port number. In this file you must add the next line: For example: ctsql <port number>/tcp ctsql ctsql 5555/tcp ctsql The <port number> must be unique in the /etc/services file. In the "/etc" directory exists a file called "inetd.conf", where we must insert the next line: ctsql stream tcp nowait root /home/ctl/lib/ctsql ctsql system NET On some Linux versions the file inetd.conf doesn t exists. The way to invoke the database engine in such cases is described in Annex I Windows The services file must be modified. This file is placed in: windows en Windows 9x. windows\system32\drivers\etc on the other Windows versions. You must add the next line: For example: ctsql <port number>/tcp ctsql ctsql 5555/tcp The port number must be unique in the services file. Pág. 3

4 The ctsql service will be activated in Windows servers when is installed following the steps detailed bellow: The user that starts the service must be an user with administrative privileges in the local domain. The user s name length must not be longer than 8 characters (see Annex II), and the security policies described in Annex III must be active. The database users must be local users of the local server domain, and must have active the security policies described in the previous case. The service must be registered with the register.exe file, placed in the bin directory of the MultiWay installation. In order to activate the service in Windows servers, you must exec the mwlisten program (see Annex IV). NOTE: The security policies activation process is different in domain servers than servers without domain (see Annex III). 1.2 Client side computer Insert the same line shown in the previous section in the services file: windows on Windows 9x. windows\system32\drivers\etc on the other Windows versions. /etc in UNIX and Linux. The <port number> must be the same tan in the server side and must be unique. If that line is in the last line, you must insert a page break. Pág. 4

5 2. Annex I. The inetd process to invoke the database engine in some Linux versions In some cases the inetd.conf file doesn t exists. Instead there is a directory called xinetd.d, where are placed all the defined services, and where you must add the new file for the ctsql service called ctsql, with the same file permissions than the other files in the directory. For that you must follow the next steps with the root user: cd /etc cd xinetd.d vi ctsql You must add the next lines: # default: on # description: The ctsql server serves ctsql sessions service ctsql { socket_type protocol wait = stream = tcp = no instances = 100 user server server_args log_on_failure = root = $TRANSDIR/lib/ctsql = system NET += USERID port = 5555 } You must replace the $TRANSDIR string with the path where is installed the Unix/Linux Multibase license. You must replace the port number with the port shown in the services file for the ctsql service. You must restart the inetd process in order to take effect these changes: Kill 1 <inetd process number> In some OS the command can be: kill 10 (check the manual man kill ). The command restart service xinetd is also valid. In other systems (Linux systems with xinetd daemon instead of inetd daemon), you must exec the /etc/init.d/xinetd restart. Pág. 5

6 2.1 Variations to this configuration The instances parameter is optional. With this parameter you set the max number of instances of the ctsql service. In the server_args section, and only if the previous configuration doesn t works, you can try to put ctsql before the system string. If you want to activate the user identification option with the -dm parameter, you must replace the system word with the -dm word. For example: -dm NET In the server_args section, the system 3.0 string shows the installed CTL version. The 0.0 string can be replaced with the absolute path of the CTSQL environment file. NOTE: In the /tmp/startsql.log file you can see the results of the ctsql start process. Pág. 6

7 3. Annex II. Profile of the starting service user The user that starts the service must have a local user with administrative privileges. Computer Management Local users and groups Users. In Windows Vista/7 select User accounts in the Control Panel. Click with the mouse s right button on the Users folder and select New User. The next window will be shown: Pág. 7

8 From Computer Management Local Users and groups Groups : If the new user is not an Administrators group member, push the Add button. Select the computer name where we have created the new user. You must push the Location button. In the edit field you must insert the user name. Pág. 8

9 4. Annex III. Activation of security policies 4.1 Domain Servers Control Panel Administrative Tools Domain Controller Security Policy : Policies for domain servers You must add the next policies: Act as part of the operating system. Log on as batch job. Log on as service. Allow log on locally. Pág. 9

10 4.2 Servers without domain Control Panel Administrative Tools Local security policies : Pág. 10

11 4.2.1 Policies for servers without domain You must add the next policies: Act as part of the operating system. Log on as batch job. Log on as service. Pág. 11

12 5. Annex IV. Activation of the CTSQL service in Windows servers Follow the next steps to activate the ctsql service: 1. Select the option menu Run in the Windows Start menú and write: c:\multiway\mwlisten.exe install ctsql Click Ok. 2. Repeat the process with: c:\multiway\mwlisten.exe d ctsql When you click Ok the next window will be shown: Click Activar Cambiar Salir. On Windows Vista/7/Server 2003/2008, instead of execute the mwlisten command from the start-run menu, you must execute the cmd command with Run As Administrator in order to have the correct permissions to execute successfully the command. Pág. 12

13 5.1 CTSQLMonitor If the CTSQL engine version is 3.4 o higher, you must start the CTSQLMonitor program. Exec the command monitor.exe : c:\multiway\bin\monitor.exe This window will be shown: To start the CTSQLMonitor you must execute the option Start in the Options menu or click the icon. To stop the CTSQLMonitor select Stop option in the Options menú or click the icon. If the installation is in a Unix or Linux server, to start the CTSQLMonitor you must execute the next statement:./monitor start To stop the CTSQLMonitor you must execute:./monitor stop Pág. 13