Hardware/Software Requirements

Chapter 1 Introduction

1.1 What is NMR-CHECK?

NMR-CHECK is an easy-to-use interface which offers features to test the basic functionality of Bruker NMR spectrometers. The major hardware components of Avance Spectrometers can be checked with just a few mouse clicks. This can be done either on-site, i.e., tests are started directly by the operator, or remotely by Bruker service personnel connected to the instrument over networks. In addition to the check of individual components, a test of the entire spectrometer is available via Internet or ISDN. After establishing such a network connection, Bruker specialists can easily work at the operating systems level of the UNIX workstation. Hence, the spectrometer operator does not have to type in compli- cated UNIX commands that were told to him over the phone.

When a high-speed communication line is available, preferably via ISDN, NMR- CHECK offers a remote control function. This means that the entire spectrometer can be simultaneously driven by the local operator and a distant Bruker partner somewhere in the world. During this session both conferees use the same, well- known XWIN-NMR interface.

3 4 Introduction

1.2 Hardware/software requirements

Computer and Operating System: INDEX Silicon Graphics (SGI): CPU R4000,DONE R4400, R4600,INDEX R5000. Operating System IRIX 5.3, 6.2, or 6.3. Spectrometer: Avance or ARX/AMX2/ASX (for hardware tests only useful when equipped with HPPR or BSMS) Software: XWIN-NMR 1.3 or newer must have been installed prior to NMR-CHECK 1.1. Release Medium: NMR-CHECK 1.1 is delivered on the NMR-Suite CD containing XWIN-NMR 2.1. Network access (optional but strongly recommended): Internet: Local routing of Bruker’s IP addresses (class B: 149.236.) from the SGI workstation to the Internet via a gateway must be accomplished. The class-C subnet 149.236.99, however, must be routed to the console computer CCU via the second Ethernet port as usual. ISDN: Basic rate interface (two B channels) S0, D-channel protocol E-DSS1 (Euro ISDN) or 1TR6 (occasionally used in Germany) required. All services (tele- phony, fax, data transmission) have to be activated. In addition, an ISDN telephone can be connected to the S0 bus. When used, however, the maximum rate of data transfer is limited to 64 kbit/s (one B channel). You should avoid connecting any additional ISDN device. ISDN cable: RJ-45 to RJ-45, pins 3 to 6 directly connected, up to 150 m long as measured from the Network Termination NT. Shielded (STP) or unshielded (UTP) twisted-pair cables can be used as well. Part numbers: 83024 (2 m), 83025 (5 m), 83026 (10 m). Indirect ISDN access via an ISDN gateway is possible. Such a gateway must use the Password Authentication Protocol PAP. A permanent PAP access name and PAP password have to be allocated. Dynamic assignment of IP addresses is permitted. SGI Indy workstations come with an ISDN controller built-in. O2 workstations require an external device, which must be connected to serial port #1. The following devices are currently supported: 1.3 Network security 5

– Elsa MicroLink ISDN/TL pro (ISDN terminal adapter; only for O2 workstations; Bruker part number: O001164) – Elsa MicroLinkINDEX ISDN/TL V.34 (ISDN terminal adapter/modem combination; must be connected to an S interface; primarily for Bruker Service Centers; INDEX DONE0 ISDN functionality only available on O2 workstations; Bruker part number: O001163) Telephone network: Conventional analog telephone interface. Supported external devices: – Elsa MicroLink 33.6TQV (high-speed modem; can be used with Indy and O2 workstations; Bruker part number: O001162) – U.S. Robotics Sportster high-speed modems (can be used with Indy and O2 workstations)

1.3 Network security

NMR-CHECK is primarily designed to operate with computer networks, though it can also be used on isolated spectrometer workstations. To assure highest network security, the SGI computer should be connected to an ISDN interface. The most prominent security features implemented in NMR-CHECK include: •NMR-CHECK can be launched by authorized personnel only. The password of the NMR superuser has to be entered. This password can be freely defined by the system administrator. •NMR-CHECK prints a detailed warning if there is any account in the system that is not protected by a password (user account) or not locked (special account). •NMR-CHECK supports shadow passwords. •NMR-CHECK supports the Network Information Service (NIS). • Remote access by Bruker is performed via a temporary service account. This account is automatically created when NMR-CHECK is started up. Its password and permissions have to be defined at the same time by the operator. The service account is automatically removed from the system when NMR-CHECK is terminated. This means that not even Bruker has access to the instrument when NMR-CHECK is not running. • ISDN/modem access is a two-step process. Before logging into the system in the background via the service account, the ISDN call has to be established. This task is controlled by the Password Authentication Protocol (PAP). The 6 Introduction

necessary account for this purpose has to be created with NMR-CHECK and is not usable for any other system access. •NMR-CHECK automatically logs the date, time,INDEX duration, and identification of any incoming and outgoing ISDN/modem call. Failures are also registered. DONE INDEX 1.4 Version

This manual applies to NMR-CHECK version 1.1. NMR-CHECK contains this manual as on-line documentation accessible from the Help menu. New features added in release 1.1: • SGI O2 workstations can be connected to the ISDN or the telephone network via external terminal adapters and modems. • The setup topic ISDN Daemon has been extended to PPP Daemon because of the additional support of terminal adapter and modem connections. PPP (Point- to-Point Protocol) is used for ISDN as well as modem links and, therefore, acts as a generic name for dial-in connections throughout NMR-CHECK. • View/On-line Statistics opens a new PPP Status display, which allows for the easy monitoring of data transmitted/received via external communication devices.

1.5 Support

Software support for NMR-CHECK is available from your local Bruker office or via e-mail from the following address: [email protected] The Bruker FTP servers ftp.bruker.de and ftp.bruker.com provide additional information such as known bugs and their workarounds in the directory /pub/nmr/nmrcheck/.

1.6 Installation of NMR-CHECK

NMR-CHECK can be separately selected as an installation item from the NMR-Suite 1.7 Starting up NMR-CHECK 7

installation dialog window SWIM. NMR-CHECK 1.1 can only work if XWIN-NMR 1.3 or newer as well as the ISDN Execution Environment (isdn_eoe), the Point-to- Point Protocol SoftwareINDEX (eoe2.sw.ppp @ IRIX 5.3, eoe.sw.ppp @ IRIX 6.x), and the UUCP Utilities (eoe2.sw.uucp @ IRIX 5.3, eoe.sw.uucp @ IRIX 6.x) have been installed priorINDEX to NMR-CHECKDONE. When using ISDN under IRIX 5.3, the installation of patches 363 and 531 is strongly recommended. Those patches are available from /CDROM/unix/patches5.3/.

1.7 Starting up NMR-CHECK

1.7.1 Operator restriction

NMR-CHECK can be started by anyone who has a login account on the SGI workstation. Click on Find/Applications inside the SGI Toolchest, and double click on NMR-CHECK’s icon, which is shown in Figure 1.1. If the main window of NMR- CHECK does not pop up, open a console window by clicking on System/Utilities/ Start New Console (IRIX 6.3) or System/Start New Console (IRIX 6.2, 5.3), and try again. Alternatively you can start NMR-CHECK by typing

Figure 1.1 NMR-CHECK’s desktop icon

nmrcheck from a UNIX shell, no matter what directory you are in. You will be prompted to enter the NMR superuser password (cf. section 1.3). Ask your system administrator if you do not know this password.

1.7.2 Create a temporary service account After the NMR superuser password has been typed in, a menu as shown in Figure 1.2 pops up. 8 Introduction

INDEX DONE INDEX

Figure 1.2 Definition of temporary service access

Type in a password of your choice with at least four alphanumeric characters. Characters in excess of eight are redundant as usual. Permission: full means that the service account will be equivalent to the root account. Thus, the entire file system can be inspected and corrected during an on-line session. Permission: restricted creates a service account which has the limited rights of a regular user. The service account is used for NMR-CHECK’s diagnosis and UNIX support features. No password of any existing account has to be revealed, and no extra account has to be created by the system administrator in order to enable remote access. Clicking on OK causes the automatic generation of the service account. NMR-CHECK is now ready to use. Keep in mind that the service account will be automatically removed from the system when NMR-CHECK is terminated (cf. section 1.3). If the account already exists at start-up time for some reason, you have to confirm the password update.

1.8 Using the mouse or the keyboard

Within NMR-CHECK, you can use the mouse or the keyboard to select items and 1.9 Appearance of the mouse cursor 9

execute commands, and to position the text cursor. • In order to execute a function represented by a button or a menu item, either click on it usingINDEX the left mouse button, or hit the Enter key once it is selected. • In order to selectINDEX the next orDONE previous button in a window for execution with Enter, use the Tab or Shift +Tab keys. • In order to select the next or previous menu item or list box item, use the Down Arrow or Up Arrow keys, or the left mouse button. • In order to move the text cursor within text entry fields, use the Left Arrow or Right Arrow keys, or the left mouse button. • Hitting the Enter key while editing a text field executes the Save function. • In order to close a window, click on the right-most button (Cancel or Quit) or press the Esc key. The click-away function (double-click on the upper left cor- ner of the window) is available only for login windows. • The passwords for ISDN access (Setup/Hosts Configuration/Modify/ISDN/ Password:) and on-line service (Setup/Hosts Configuration/Modify/Service/ Password:) can be made visible by double-clicking with the left mouse button inside the entry field, or by selecting the field and pressing the Print Screen key. • Computer names in list boxes can be chosen by double-clicking with the left mouse button. • In addition to moving the scroll bar, browsing through list boxes can be performed by keeping the middle mouse button pressed inside the list box and moving the mouse appropriately. Alternatively, the Page Up/Page Down keys can be used when the list box has been selected with the Tab key.

1.9 Appearance of the mouse cursor

Outside entry fields, the mouse cursor appears as an arrow. When NMR-CHECK is working, the mouse cursor changes to a watch. During this time NMR-CHECK does not accept any user interaction. Be patient! Some of the diagnosis procedures take minutes until completion. Therefore, you will be informed about the approximate duration of every single test. If you think that NMR-CHECK has crashed because it does not seem to be active anymore, wait a little longer. Terminate the UNIX pro- cesses belonging to NMR-CHECK only if you are positive that NMR-CHECK has crashed! 10 Introduction

Warning: If you terminate NMR-CHECK on the UNIX level while an ISDN connection is open, this line might remain open (producing telephone charges)! In such a case, start NMR-CHECK again and stop it orderly withINDEX the Exit function. DONE INDEX 1.10 Tear-off menus

All menus except File and View can be torn off by clicking on the dashed line at the top of the menu. You can move a tear-off menu to a place on the screen where it is always accessible. It will even stay open when NMR-CHECK’s main window is being iconified. This feature is especially useful for the Multidisplay and Diagno- sis menus.