3.1 Getting Started in Windows

There are six basic steps to using AcuServer^® file server software in a Windows environment.

Install AcuServer. If you have not already installed AcuServer on your Windows NT, Windows 2000, or Windows 2003 server, please refer to sections 3.2 and 3.3 of this chapter for a list of installation requirements and procedures. If AcuServer is already installed, then proceed to the next step.

There is nothing on the AcuServer distribution media to install on the client machine. However, you should ensure that every client system that will use AcuServer has a licensed copy of an ACUCOBOL-GT® runtime, Version 7.2 or later, and you may need to set up client passwords, user names and host names. This is described in section 3.6, "Installing the Client."

Set up user and/or group accounts. Decide how users will access resources on the server machine (individual accounts or group accounts). Section 3.4, "Setting Up Accounts," shows the tradeoffs. Create the user accounts and grant user rights, including access to the server from the network.

Edit the AcuAccess file on the server. AcuServer will not start if the server access file cannot be found. By default, this file is named "AcuAccess" and located in the "c:\etc" directory. (If your server's operating system is located on a drive other than "c", AcuServer will look for the AcuAccess file in the "\etc" directory on the drive containing the operating system.)

Step by step instructions for configuring the access file are included in section 6.4.1, "Creating or Opening an Access File." General information about the file is included in section 6.2, "The Server Access File."

If you choose to implement AcuServer system security, each record in the server access file should contain client machine name, client username, local username, and umask data. Passwords may also be defined if desired.

If you choose to implement Windows NT security rather than AcuServer system security, the access records need only contain client machine, username, and if using the LOGON option, password data.

If the access file is not owned by Administrator or the Administrators group, or is writable by users that do not have Administrator privileges, AcuServer will not start.

Create or modify the directory structure that will be used by AcuServer clients. Ensure that user accounts have FULL CONTROL access to the directory containing the data and object files. If files already exist, modify the permissions for each file to give the users FULL CONTROL access.

Configure the AcuServer system. AcuServer system configuration consists of:

Assigning values to the runtime configuration variables. With the exception of the FILE_PREFIX and possibly CODE_PREFIX variables (discussed later in this chapter), none of the runtime configuration variables requires modification. For information about runtime configuration variables, see section 4.2.1, "Runtime Configuration Variables."

Assigning values to the AcuServer configuration variables. None of the server configuration variables requires modification; however, you may want to modify them to gain control over or initiate certain functions like file locking, multi-record mode, or error trace flushing. If you want to implement Windows security rather than AcuServer system security, you must set the SECURITY_METHOD variable in both the runtime and server configuration files. For information about server configuration variables, see section 4.2.2, "Server Configuration Variables."

Modifying your runtime configuration file or application code to use remote name notation. To use AcuServer, your applications must use remote name notation to refer to files located on the server. The ACUCOBOL-GT runtime looks for remote name notation to identify requests to AcuServer. On Windows NT/2000 servers, the format for this notation is "@servername:drive-letter:\pathname". You may add a remote path to the FILE_PREFIX or CODE_PREFIX configuration variables. Alternatively, you can define file name aliases in the runtime configuration file. A file name alias is a string that will replace the literal name in the ASSIGN TO clause of a SELECT statement. For more information on remote name notation, please refer to section 7.2, "Accessing Remote Files."

Issue AcuServer commands. AcuServer requests are handled by the acuserve service running on the server. You can use the Windows AcuServer Control Panel or the command line to start and stop AcuServer (the acuserve service), retrieve AcuServer operation status, unlock stranded files, and create and maintain the server access file. For details about the AcuServer Control Panel and the acuserve command, see Chapter 5, "AcuServer Functions."

Please be aware that configuration of AcuServer system security is very important to safeguarding your data files and network computers. We urge you to read the security information covered in Chapter 6, "System Security," before placing AcuServer into open service.