Installation
The Windows installer will create a service for the server and desktop links for the Accendia Browser. A Java Runtime is deployed with the installation package and no additional Java installation is required.

For other platforms download the JNetStart tar file and uncompress creating the directory structure of the product. The root directory of the installation will be referred as JNS_ROOT. A Java Runtime is not included in the JNetStart installation package. You must download and install JRE 1.6.0 or later.

License
JNetStart is delivered with a default license for 2 simultaneous client connections. A production license must be purchased in order to enable unlimited client connections.

To activate the purchased license:

  • Open the license key file JNS_ROOT/license.key in a text editor.
  • Paste the license key string into the file.
  • Restart the server.
Verify the Installation
The Windows installer creates and starts the JNetStart service. If you choosed not to create or start the service you can start the server manually running the JNS_ROOT/server/run.bat script. The startup script run.sh is provided for UNIX. You may use it to create the startup script for your platform.

By default the server is configured to open the server ports 80 for the HTTP service and 443 for the JNetStart communication. You must change the default configuration if these ports are used by other applications.

Start Internet Explorer or Firefox and browse to http://hostname where hostname is the name of the computer where the JNetStart server is started. If you are using Firefox you will be redirected to the JNetStart plugin for Firefox installation page. Click on the XPI installation link and accept to install the plugin then browse to http://localhost. If you are using IE you will be automatically prompted to install the JNetStart plugin. The main page contains links for the JNetStart Administration Console and the SwingSet2 sample application. Click on the "SwingSet2 - JFrame Demo" link.

Start the Accendia Browser and enter http://hostname/jns.html into the location line. The page will contain login forms for starting the sample client applications deployed on the sever. Press the ok button in the SwingSet2 form. The applet SwingSet2 will be loaded on a new tab in the browser.

Change the Password
You need to login to the server in order to launch applications or to perform administration tasks. The following user accounts are included in the installation package:

User Name Password Description
administrator change User with administration and application launch privileges. You must login into the administration console and change the administrator password.
guest password User with application launch privileges. Login as administrator and remove this user or reset the password if you want to restrict launching applications installed on the server to a certain group of users.

Configuration
The server configuration files are located in the JNS_ROOT/server/cfg directory:

File Description
config.properties Properties file containing server parameters:

server.http HTTP service port.
server.port The JNetStart Server port used for application launch and administration.
server.https HTTPS service port, by default commented out. Uncomment to enable HTTPS service only after installing a Java security certificate.

You are not expected to change other default server parameters.

logging.properties Default Java logging configuration file. The logger used by the server is SocketSrv.
ext2mime.cfg Properties file containing file extension to mime type mappings for the HTTP service.

Server Components
JNetStart Server components are organized under the following directory structure:

Directory Description
/api Contains an applet jar file and a frame jar file. The frame jar file is used by the JNetStart plugin to launch frame applications. The applet jar file contains the JNetStart bootstrap applet used to launch Java Applets. Both jars contain the secure services API. The application developer needs to compile with one of the two jars only if using secure services.
/browser Contains the Accendia Browser files. Use the browser.bat to start the browser from the command prompt. Applet developers may edit the script to enable remote debugging of client applications.
/client Contains the JNetStart command line client NetStart.exe. The command line client can be used to test remote applications without creating and deploying client web pages containing the application links.
/console Contains the JNetStart Administration Console. Start the console from command prompt using run.bat for Windows or run.sh for UNIX. The administration console is also deployed by default on the server and can be launched using the browser.
/html The HTTP service root directory. Contains the index.html page with links to the JNetStart administration console and sample applications.
/html/doc JavaDocs for the secure client services API .
/html/guide JNetStart Administration and Development Guide.
/jns The JNetStart server code.
/jre The Java Runtime Environment deployed with the JNetStart installation.
/plugin Contains the IE plugin (.cab) and the Firefox plugin (.xpi).
/server The Iris Server framework.
/swing The user applications are deployed under this directory. For each application deployed the server will create a subdirectory with the name application_name.creation_timestamp. The user application jar files and classes will be copied under the corresponding application subdirectory.