Version 2.0. Installation Guide

(1)

Installation

Guide

Rev. D-26/02/2001

Version 2.0

(2)

Copyright

This document and the accompanying software package are subject to international copyright laws. No part of this document may be reproduced or transmitted in any form without the prior consent of Rising Software.

Trademarks

Musition, Auralia and Rising Software are trademarks of Rising Software Australia Pty. Ltd.

Microsoft, Windows and NT are either registered trademarks or trademarks of Microsoft in the United States and other countries. All other companies and product names are trademarks or registered trademarks of their respective holders.

User Guide Authors

Peter Lee Hamish Moffatt Tim Wilson

The authors may be contacted at:

Rising Software Australia Pty. Ltd. A.C.N. 077 057 213 31 Elmhurst Rd, Blackburn,

Victoria, Australia, 3130.

Phone: +61 3 9894 4788 Fax: +61 3 9894 3362 USA Toll Free: 1 888 667 7839 www: http://www.risingsoftware.com email: [email protected]

(3)

You must have already installed Windows 95, 98 or Windows NT on your computer to install Musition. Installation will take approximately 15 minutes, and requires 40Mb of free hard disk space. The Musition installa-tion will copy Musiinstalla-tion to your hard disk and configure it for your use. 1. Firstly, start Microsoft Windows, and insert the CD-ROM provided

with the package into the CD-ROM drive.

2. A welcome screen should automatically appear when the CD-ROM is inserted. If a welcome screen does not appear:

* Click on the ‘Start’ menu and choose ‘Run’.

* Enter ‘X:\auralia\setup’, where ‘X’ is the drive letter of your CD-ROM drive. Now press ‘Enter’ on your keyboard. 3. The Installshield Wizard will now guide you through the setup

process. You will need to enter your serial number at the beginning of the installation for Musition to work correctly. This serial number is located on the inside front cover of the ‘User Guide’ and on your license agreement. If you are upgrading Musition, you will need your previous version serial number; you may need the original CD-ROM or diskettes.

4. Musition installation is now complete. You may need to change some settings if you have an unusual sound or MIDI configuration; see the section on MIDI and Wave Setup in the ‘User Guide’. You can also prevent access to the administration menus if you chose to enable the login system; see the ‘Security’ section of the ‘User

Guide’.

12 Rising Software

enable the network databases when Musition is restarted. If the box marked ‘Use shared Settings’ is enabled, Musition will read the MUSITION.INI file from the server rather than from the local hard disk. The MUSITION.INI file contains your

administration choices such as whether to use security or not and which MIDI Input device to use. If you have the same MIDI Input device available on every computer on your network, you should use this option to make configuration changes apply immediately to all your computers. If some computers have a different MIDI Input setup, you can use the local INI file on those machines alone. ‘Use shared topic data and program files’ will enable Musition to use topic data from the network directory, so that any custom topic data that you enter (eg. chords) will be used on all workstations.

Click on ‘Ok’ to save your settings and exit the network screen. 2. Select ‘Administration -> General -> Security’ from the main menu.

Check the the box labeled ‘Use names and passwords at all times’. If you did not add an administrator user correctly in the ‘Server

Installation’ section, Musition will not allow you to select this

option. This is to prevent the enabling of the login system without having an administrator defined, a situation that will leave you locked out of the administration features. Click on ‘Ok’ to exit the Security screen.

3. Select ‘Administration -> Users -> Options’ from the main menu. ‘Automatic User Registration’ and ‘Allow users to change their settings’ should be checked for minimum maintenance. For a complete guide on these settings refer to the section entitled ‘User Administration Options’ in the User Guide. ‘Record Statistics’ should also be checked for maximum benefit in a network environment. This will ensure that all results are recorded.

(6)

6 Rising Software

We recommend the use of 800x600 video resolution with at least 256 colours for maximum picture quality. Performance may be affected if this is not available.

Installation Notes

Musition 2.0 will install files into two directories (folders). They will both stem off a directory called ‘Rising Software’. It is absolutely essential that this directory structure is not altered in any way. It is possible, to rename the ‘Rising Software’ directory to a different file name (perhaps if your file system does not support long filenames.)

The ‘Data2’ directory contains databases which contains user, class, test and topic details. The statistics databases are also kept here. There is a good reason for having these in a separate directory:

Auralia 2.1, Rising Software’s ear training package will utilise the databases in the data directory. This means that you will have only one set of data and statistics to deal with.

Imagine that you have 100 students using Musition 2.0 on your computer. You then add Auralia 2.1. Instead of having to print and maintain two sets of statistics for the students, you only have one. The students only need one login name and password.

Rising Software

Auralia21 Data2

Musition 2.0 Installation Guide 11 click on the Tab labelled ‘Configuration’. Change the setting ‘LOCAL SHARE’ to be TRUE on the System page.

Enabling Network Functionality

Each workstation now needs its Musition configuration changed to allow network database access. Ensure that you have added an administrator

user to the network database as described in step 3 of ‘Server

Installation’

1. The first task is to setup Musition to use the databases on the server, instead of the local machine.

Start Musition and select ‘Administration -> Network’ from the main menu. Using the browse button, choose the path of your ‘Rising Software’ directory. This directory should contain the subdirectories ‘Musition2’, ‘Data2’ and ‘Network’, as described in the ‘Server

Installation’ section.

The directory can referenced by using a mapped drive letter, or, preferrably, using UNC. An example of each is shown below, together with the UNC syntax.

Mapped Drive Letter

Y:\APPS\MUSIC\RISING SOFTWARE\ UNC

\\SERVER\APPS\MUSIC\RISING SOFTWARE\ UNC Syntax

\\(server name)\(share name)\(path)

Using UNC will result in a more stable system and is highly

recommended. Regardless of which method is used, the setting must be exactly the same on all workstations. This will prevent data loss and corruption.

(7)

Network Installation

Network Functionality

In an environment where Musition is installed on many computers (Desktop

Site License, Lab Pack or multiple Single Licenses required) we recommend

that you utilise your computer network (if available) to help you track student performance. Musition fully supports networked record

keeping. This means that all of your student results can be stored centrally,

reducing your administration load and giving students far greater flexability regarding the choice of computer that they use.

All user, class, statistic and test databases can be stored centrally and a central configuration file can also be used. Musition 2.0 will share data with Auralia 2.1, allowing students to use the same user names and pass-words for either program. Class, statistic and test data will also be shared.

Network Installation Instructions

If you are running Windows from a local hard drive on each computer, Musition 2.0 must be installed on each computer on your network. It is not

possible to simply install Musition onto the server and run it on each of the clients; some system DLLs and registry keys must be installed on each computer by the setup process.

The setup process will also add shortcuts to Musition on the Start menu under ‘Programs’. Once Musition is installed on each workstation, it can easily be setup to read databases and configuration from a network server. Third-party automated installation software may make it easier to install Musition on all computers if you have many.

10 Rising Software

Workstation Installation

Musition must be installed on each workstation; Musition cannot be run from the server installation.

1. Install Musition on each of your workstations. Third-party automated installation software may make this process easier. It is advisable to read the following sections entitled ‘Workstation BDE

Configuration’ and ‘Enabling Network Functionality’ before

installing on all workstations, especially if you use a specialised installation product to install Musition.

NOTE: If you used a workstation to install Musition onto your server, ensure that you REINSTALL Musition on this workstation.

Workstation BDE Configuration

There are issues to be resolved when using Musition on Peer to Peer networks (where each machine acts, or can act, as both a client and a server.) and also Client-Server Networks.

If you wish to achieve a reliable network database system, we do not reccomend using a Peer to Peer network situation, such as Windows 95 or Windows 98 networking. We recommend using a dedicated server such as Windows NT or Novell Netware. Various UNIX implementa-tions should also work well.

Musition utilises the Borland Database Engine, which provides database services for record keeping and tests, among other things. The setup of the BDE is not automatic on either Peer to Peer or Client-Server networks. To ensure the databases work correctly, there is an option that you must set on each client machine, to allow the BDE to function correctly. You will utilise the BDE Administrator, which can be found under the Control Panel in both Windows 95, Windows 98 and Windows NT. If either of the following errors occur, double check the setting as outlined below.

* Directory is controlled by other .NET file... * Multiple .NET files in use...

(8)

8 Rising Software

Server Installation

Musition is installed onto the server to provide databases and configuration files required for successful network installation and usage.

Musition will install files into two directories. Both of these directories will stem off a parent directory called ‘Rising Software’. It is absolutely essential that this directory structure is not altered in any way. It is possible to rename the ‘Rising Software’ directory and some installations may require this; see ‘Network operating system issues’.

Rising Software

Musition2 Data2 Network

1. Install Musition onto your server using one of your workstation computers; if you are running a Windows server, you may install it directly using the system console if you wish. When Musition is installed, check that the directory that you installed it into contains the correct directories as shown above.

The ‘Network’ directory stores temporary network files, and must be available to all users.

2. We are now going to add you to the user database that resides on the server. On the workstation or server console where you installed Musition, run the program. Select ‘Administration -> Users’ from the main menu.

a. Enter a login name b. Enter a password c. Select the Default Class d. Choose ‘Administrator’ access

Click on ‘Accept’ and then ‘Ok’ to exit the screen. You now have an

Musition 2.0 Installation Guide 9 ‘Administrator’ user in the databases. This will ensure that you cannot be locked out of Musition when the security features are enabled.

File Permissions

For maximum security and performance, we recommend that you set file permissions as outlined below. This will ensure that ‘student’ users cannot comprimise the integrity of your result databases.

S R O T A R T S I N I M D A e r a w t e

N WindowsNT Windows2000 2

a t a

D Read,Write,File

e t a e r C , n a c

S Change Read,Write

k r o w t e

N Read,Write,File

e t a e r C , n a c

S Change Read,Write

2 n o i t i s u

M Read,Write,File

e t a e r C , n a c

S Change Read,Write

S T N E D U T S e r a w t e

N WindowsNT Windows2000 2

a t a

D Read,Write,File

e t a e r C , n a c

S Change Read,Write

k r o w t e

N Read,Write,File

e t a e r C , n a c

S Change Read,Write

2 n o i t i s u

M Read,FileScan Read Read

Student users should not have delete access to any directories, as this could allow damage to the databases and the Musition configuration.

Version 2.0. Installation Guide

Installation

Guide

Version 2.0

Contents

Network Operating System Issues

Installing Musition

Installation Instructions

Installation Notes

Enabling Network Functionality

Network Installation

Network Functionality

Network Installation Instructions