How to administer a remote Nirvana Realm
A typical development setup involves installing a Nirvana Realm in a remote development server as well as the developer's workstation. This guide will help you connect to the remote development Nirvana realm for administration purposes.
A Nirvana realm by default enforces a security model that allows only the username running the server process to connect to it with full priviledges, and that can only be done when connecting from localhost (127.0.0.1). Therefore, in order to be able to connect remotely you need to add an ACL entry for the user and the IP address you will connecting from. To do this you need to use the naddrealmacl command line tool on the development server as follows:
Windows OS Server Steps
- Open a client command prompt from the Start Menu shortcut
- Type naddrealmacl <user> <ip> full where <user> is the OS username that the development workstation will use to connect and <ip> is the ip address of the development workstation. In this instance we specify that full access should be given to this user.
Linux / Solaris Server Steps
- Open a console window (shell)
- Type cd <install dir>/client/<realm_name>/bin where <install_dir> is your installation path and <realm_name> is the name you assigned to the realm during installation.
- Type export RNAME=nsp://localhost:9000 , this sets an environment variable called RNAME that all samples and command line tools use in order to know how to connect to the server. In this instance we are using the Nirvana Socket Protocol on localhost and port 9000. If you have chosen a different port please adjust accordingly.
- Type ./naddrealmacl <user> <ip> full where <user> is the OS username that the development workstation will use to connect and <ip> is the ip address of the workstation. In this instance we specify that full access should be given to this user.
Development Workstation Steps
- Run your enterprise manager on the development workstation and click on the Connections menu, selecting Connect To Realm.
- A dialog will pop up asking you to specify the RNAME to use. Similarly to what we did for the command line tool, we specify nsp://<server ip>:9000 where <server ip> is the IP address where the server is running and 9000 is the port the server is listening on. Again if you have chosen a different port please adjust accordingly
- Click ok and you should see your realm appear in the tree under the Realms folder.