INSTRUCTIONS FOR INSTALLING ONLINE SERVICES SOFTWARE ON LINUX COMPUTERS

Contents:

Section 1 – Overview and System requirements
Section 2 - Installation Instructions for Linux 
Section 3 - Contact us
Section 4 - Frequently asked questions


Section 1 – Overview and System requirements:

1.1 - Overview

The CSI is a software component that enables secure transactions over the internet, using digital certificates.

You need to install CSI to install your digital certificate and use our online services.

For more information on CSI, go to www.csi.business.gov.au

1.2 - Digital certificate and PIN

Before downloading a certificate, you must have the CSI software installed on your system and you will need to have the Digital Certificate PIN letter (containing your PIN). If you don't have this item, please contact the Technical Help Desk (see Contact us below). 

1.3 - System requirements:

To run the Common Signing Interface (CSI) once installed you will require a:

•	Java runtime engine – version 1.4.2_06 to be installed on your computer. Security flaws have been discovered in previous versions of java. Although the CSI software will function with previous versions of java it is strongly recommended that you install version 1.4.2_06.
•	An internet browser that can be configured to use the java plug-in.


==============================================

Section 2 - Installation Instructions for Linux

2.1 – List of files included in the CSI zip file

The following files are included in CsiInstallForLinux.zip:
•	csi.jar -	 The executable CSI code
•	jce1_2_2.jar – java cryptography extension   
•	local_policy.jar – local security policy file
•	US_export_policy.jar – US export security policy file
•	csi.sh – a script file to invoke the CSI Management Utility once it is installed
•	licence_agreement.txt – The terms and conditions of use for the CSI
•	csiIcon.ico – an icon file for customizing your csi.sh file.

2.2 - Installing the CSI

1.	Install java version 1.4.2_06 and configure your browser to use the java plug-in. Visit http://www.java.com/en/download/help/testvm.jsp to test that you have java correctly installed.

2.	Read the license_agreement.txt file and if you agree to the conditions continue the installation. If you do not agree with these conditions, discontinue the CSI installation.

3.	Create a directory called CSI in your home directory and extract the files from the zip file into this directory.

4.	Copy the csi.jar file to the $JAVA_HOME/lib/ext directory.
NOTE: $JAVA_HOME is a user defined environment variable denoting the path to the java installation directory.

5.	Copy the local_policy.jar, jce1_2_2.jar and the US_export_policy.jar files to the $JAVA_HOME/lib/security directory.

6.	Copy the csi.sh file to the location from where you wish to invoke the CSI Management Utility.  

(The csiIcon.ico file is included in case you wish to customize your csi.sh file icon)

2.3 - Downloading and installing your digital certificate

When CSI is installed, you can download your certificate at http://pki.ato.gov.au/atocdia/welcome.htm provided that you have an Internet Browser that will support the java plug-in.

==============================================

Section 3 - Contact us

Please note: The files included in the zip file can be installed on multiple platforms including Windows (ME, 98SE, NT4, XP and 2000), Mac OSX and various flavors of the Linux Operating system. However, only users with Windows and Mac operating systems are provided with technical support. If you are installing the CSI on to a machine running a Linux operating system, please be aware that no testing of the CSI has been performed and no guarantee is made that the software will function correctly.

For help:

- phone the technical help desk 1300 139 373, Monday to Friday, 8am to 8pm (nationally), or 

- email technical.help@ato.gov.au 

For general information on our range of our online services visit www.ato.gov.au/onlineservices



