INSTALLATION AND CONFIGURATION OF ARP2004 Overview You will need to perform one initial installation of ARP as described below under "Initial Installation". This can be either a standalone installation (if you wish to run ARP only from one PC and install it on that PC's local drive) or a server installation (if you want ARP's data files to reside on a server drive). The initial installation procedure is the same for both standalone and server installations. The purpose of the initial installation is to load the files necessary to run this year's version of ARP. After loading the ARP files, you will need to perform a workstation installation on each PC that will access ARP. If the ARP files reside on a server, this means performing a workstation installation on each workstation that will access ARP. If the ARP files reside on a PC's local drive and ARP will be run only from that PC, you will need to perform a workstation installation only on that PC. Each PC that accesses ARP must be running a 32-bit version of Windows (Windows 95 or later). The purpose of a workstation installation is to install or update the DLL's and other system files necessary for a PC to run ARP, and to set up a Windows icon for running the 2004 version of ARP. The workstation installation is generally NOT required on any PC on which last year's (2003) ARP setup has already been run, providing the PC's operating system has not been replaced or re-built since the running of last year's setup program. Any ARP bug fixes, updates, etc. will be made available via an updated ARP executable (arp2004.exe). Updates and bug fixes will generally be announced via the GCRC list servers, but you can check for updates by checking the date on the file ARP2004.exe at the following URL: http://verne.med.unc.edu/ftp/arp/fixes If the date on this file is later than the date on the existing copy of ARP2004.exe in your ARP "program" subdirectory, then you should update your copy of ARP2004.exe. If you ran ARP last year, it is IMPERATIVE that you install this year's version ON TOP OF last year's version. The 2004 installation will (1) preserve previous years' data and (2) update previous years' program files to ensure your ability to access previous years' data in the future. Specifically, the 2004 installation will place the following executables in your ARP program subfolder: arp2000.exe arp2001.exe arp2002.exe arp2003.exe arp2004.exe See the section below entitled "Step 3: Configure ARP" for suggestions on setting up Windows icons to access different ARP years. Step 1: Copy ARP2004 files to main ARP folder ('ARP root") If you used ARP last year, you should already have an ARP folder that contains last year's ARP program and data (this folder will be referred to as the "ARP root"). The 2004 ARP files should be copied ("unzipped") into that folder. In doing this, you will not over-write last year's data. However, it is always advisable to make a backup copy of your pre- existing ARP installation (ARP directory and all its subdirectories and files) before you install a new version. DO NOT ATTEMPT TO INSTALL ARP IN A NEW DIRECTORY AND THEN COPY IN PREVIOUS YEARS' FILES. THIS COULD IMPAIR YOUR ABILITY TO PROPERLY ACCESS PREVIOUS YEARS' FILES. If you are a new site and did not use ARP last year, you should create a new folder to hold the ARP files (this folder will be referred to as the "ARP root"). The folder should be placed on a file server if ARP will be accessed from more than one PC, otherwise it may be placed either on a file server or on a PC's local hard drive. To copy ARP files to your ARP root: 1. Place ARP2004files.exe in your ARP root folder. 2. Invoke ARP2004files.exe from within Windows. This is a self- extracting archive; its files will be placed in the ARP root and its subfolders. Some of last year's program and documentation files may be replaced; this will not compromise your ability to access last year's ARP data. Step 2: Set up PC's to access ARP This step is required on any PC that will run ARP, except PC's on which last year's (2003) ARP setup has already been run successfully. This step will update system files (DLL's, etc.) to allow ARP to be run. To set up PC's, you should follow these steps: 1. Close all Windows applications and make sure you are logged in with administrative privileges on the PC on which you are running setup. 2. If the PC is running Windows95 or Windows98, you should install DCOM95 or DCOM98. You can download DCOM95 (for Win95) or DCOM98 (for Win98) as a self-extracting archive from: http://verne.med.unc.edu/ftp/arp You do NOT need to install DCOM on PC's running Windows NT 4.0, Windows2000, Windows ME, Windows XP, or any other version of Windows later than Windows 98. 3. Download ARP2004Setup.exe from http://verne.med.unc.edu/ftp/arp and place this file in a temporary directory. (If you need to install ARP on more than one PC, this temporary directory should be on a server so that it is accessible from each PC.) Then invoke ARP2004Setup.exe from within Windows to extract its contents, which will include setup.exe. 4. Run setup.exe from each PC that will run ARP. When Setup asks you for a destination folder for the installation, you should specify your ARP root folder (e.g., G:\ARP) into which ARP2004Files.exe was extracted. Setup will update DLL's and other system files on the PC. If the installation asks whether you wish to update a DLL that already exists on the PC, you should (a) replace it if the version on the PC is older than the installation's version, and (b) NOT replace it if the version on the PC is newer than the installation's version. Setup may display one or more error messages indicating that it was unable to register MSJRO.DLL, MSDART32.DLL and/or MSADOX.DLL. These specific error messages will not adversely affect the installation of ARP. Simply click the Ignore button to proceed. After system files on your workstation have been replaced, setup may inform you that your PC needs to be restarted. Allow it to be restarted, then re-invoke setup.exe to complete the installation after re-booting. Step 3: Set up a Windows icon for ARP2004 On each PC that will access ARP, create a new Windows icon for ARP2004, label it to clearly indicate that it is the current version of ARP, and set its target to be arp2004.exe in the "program" subfolder beneath the ARP root into which you extracted ARP2004Files.exe. The "Start In" directory for the Windows icon should also be ARP's "program" subfolder. Step 4: Install a webAPR-compatible browser, if not already installed When your ARP database is complete, you will be required to submit it to the NCRR's webAPR site. The webAPR will operate correctly only if you access it using Netscape version 4.7x, Netscape version 7, or Internet Explorer version 5 or later. As of the writing of this document, Netscape 4.7x or 7 can be downloaded from http://wp.netscape.com/download/archive.html. Netscape will need to be available on the PC that will be used to submit the ARP file, and on any PC's that will be used to access the webAPR for post-submission tasks (see ARP documentation for details). Step 5: Obtain the latest version of the ARP2004 executable After installing ARP on your server and running setup.exe on all workstations, you should ensure that you have the latest ARP fixes by downloading arp2004.exe from http://verne.med.unc.edu/ftp/arp/fixes, and placing it in the "program" subfolder beneath your ARP root folder. Step 6: Configure ARP You should consider each of the following post-installation configuration options. The first two of these are highly recommended for all sites; the others are purely optional and/or dependent upon your site's needs. 1. (strongly recommended) Enter Title Page Information. You should fill in the Title Page section before moving on to other sections in ARP, since some of the fields in this section will affect the operation of other sections. For example, if you specify on the Title Page that there was a rate change during the reporting period, separate fields will appear for each of the two rate periods in the Patient Care section and Ancillaries section; otherwise, fields will appear for only one rate period. (Note: You may wish to import the Title Page and other information, such as Advisory Committee, from last year's Annual Report. To do this, select File->Import->From Last Year's ARP from the ARP menu bar.) 2. (strongly recommended) To avoid confusion about ARP versions, you should either: a. Remove all references (Windows icons, Program menu options) to past versions of ARP from users' PC's; or b. Edit references (icons, etc.) to past versions of ARP to ensure that each reference points to the proper executable and is labeled to clearly indicate the ARP year to which it refers. 3. (optional) Assign an ARP password. By default, ARP allows access without a password. The introductory screen allows the creation of an overall ARP password. Once assigned, the password can be changed (or removed) via an option in the Tools menu in ARP. (To remove a password, select the Change Password option and delete all characters in the "New Password" and "Re-type New Password" fields.) 4. (optional) Set up separate databases for satellites. ARP allows you to set up and maintain multiple databases within a single ARP installation. ARP has no tools for merging data from multiple databases, so you should do this ONLY if your site will be submitting multiple reports representing either multiple CRC's or satellites within one CRC. In all cases, the main ARP database, which is set up for you upon installation of ARP, is called ARP2004.MDB. Use the Tools->Create New Database option to add additional databases for satellites or multiple CRC's. When ARP detects more than one database, it will present a menu and require users to select a database upon entry to ARP (unless you set a default database, as described below). Each satellite (but not the main center) must have a satellite abbreviation (code), which is entered in the upper right area of the Title Page screen. Starting in 2004, the NCRR is requiring that each satellite use a consistent code from year-to-year. ARP has been programmed to recognize the allowable codes for each grant number, and will give an error message when you run Tools->Data Validity Check if you use an inappropriate code. Please contact either Liz Wood or the NCRR if you are unsure of the correct code for your satellite(s). If you create separate databases for different sites, each database can have its own password. Thus, even if all sites share a single ARP installation, users from one site can be prevented from accessing data from another site through ARP. 5. (optional) If you have set up multiple databases in your ARP installation (as described above), you can set a default database for each workstation. To do this, create a file called ARP.CFG in the C:\ of each ARP workstation. This should be a text file and its contents should be the name of the database you wish to make the default for the workstation. Setting a default database will prevent ARP from presenting a menu of databases upon entry; users on a workstation can still access databases other than the default by using the Tools->Select Current Database option.