The NSAdmin utility is useful if you want to change your NetStorage configuration after NetStorage has been installed. NetStorage configuration information is stored in the NetWare® registry and the NSAdmin utility provides an easy method for changing NetStorage registry entries.
Exercise caution when using NSAdmin to change NetWare registry settings. Some NetWare registry entries should be changed only under direction from Novell®, and changing them could adversely affect NetStorage and your NetWare server.
After changing any registry settings you must reboot your NetWare server for changes to take effect.
To access the NSAdmin utility, do the following:
Start your browser or Microsoft Web Folders and enter the URL for the NSAdmin utility.
The URL is http://server_ip_address/oneNet/nsadmin/. Replace server_ip_address with the IP address or DNS name of the NetWare 6 server where you installed NetStorage or the IP address you chose for the Apache-based services during the NetWare 6 installation.
If you specified a port number other than port 80 for Apache-based services during the NetWare 6 installation, you must also specify that port number with the URL.
For example, if the IP address for NetStorage is 127.1.1.1 and the port number is 51080, then you would specify 127.1.1.1:51080/oneNet/nsadmin/.
Enter your username and password.
The NSAdmin Web page displays a list of links in the left column that are used to access the various pages for editing and viewing NetStorage configuration information in the NetWare registry.
Descriptions and information for each NSAdmin page are described in the following sections:
The General page lets you view or edit the following configuration settings:
The registered location you want users to enter as part of the NetStorage URL to access NetStorage. The default is oneNet.
If you change this registry setting, you must also edit a configuration file for the change to take effect. To do this, edit the SYS:\NETSTORAGE\XSRV.CONF file and change the /oneNet setting in the Location section (first section) to the same setting you specified in NSAdmin.
NetIdentity is the default certificate name. It is created automatically during the NetStorage installation. If you purchased a certificate that you want to use or you just want to use a different certificate, enter the certificate name in this field. Any certificates used by NetStorage should reside in the same eDirectoryTM context.
The amount of time in seconds that the session will remain idle before it is terminated. If there is no NetStorage activity for this amount of time, the user will be required to log in again to NetStorage before being allowed file access.
This setting should not be changed except under direction from Novell.
This setting should not be changed except under direction from Novell.
The admin username and password that you entered when you installed your NetWare server. If you want NetStorage to use a different username and password for administrator access, enter it in the fields provided. If you click the Set Defaults button the value will be set to whatever value appears in the Default Value column. If there is no value in the Default Value column the value will be set to blank (no value).
The Persistent Cookies setting can be turned either on or off. With the value set to 0, Persistent Cookies is turned off. Persistent Cookies is turned on (the default) if there is no value or the value is set to anything other than 0. With Persistent Cookies turned off, the NetStorage session will end when the user closes the current browser or Web folder. Also, if the user has a current instance of NetStorage up in a browser window or web folder and starts up a new browser instance or web folder, the user will be required to re-authenticate. Turning off Persistent Cookies can be beneficial if you have workstations that are shared because as long as the browser instance is closed down, the next user of the workstation cannot accidently or intentionally obtain access to your network through NetStorage. Leaving Persistent Cookies turned on can be beneficial if your workstations are not shared because it prevents users from having to unnecessarily re-authenticate. If the user selects the Logout option in NetStorage, the NetStorage session will end regardless of whether Persistent Cookies is turned on or off.
Lets you change or add the eDirectory server URLs and contexts that are required by NetStorage. This page also lets you change the eDirectory server that is designated as the Primary. See Installing Novell NetStorage during the NetWare 6 Installation for more information about eDirectory server URLs and contexts.
The following list identifies the functions of the buttons on the Authentication Domains page:
Adds another eDirectory server IP addresses or DNS name.
Makes the eDirectory server URL listed above the button the Primary.
Removes the eDirectory server URL from the list of URLs used by NetStorage.
Removes the context (if there is one) from the eDirectory server URL.
Adds a context to the eDirectory server URL.
Lets you view the location of the XTier, iFolderTM and NetStorage Admin handlers. The value provides a more intuitive description than what is displayed in the Location column. The Value field should not be changed.
Lets you view or edit the following configuration settings:
The location of the NetStorage WebDav provider (XDAV.NLM). It is the location you want users to enter as part of the NetStorage URL to access NetStorage. The default is NetStorage.
The directory for the HTML interface. This setting should not be changed except under direction from Novell.
This setting should not be changed except under direction from Novell.
Lets you view or edit the following iFolder-specific configuration settings:
The name of the root directory for iFolder. The root iFolder directory is a virtual directory, and changing it will change the iFolder directory name users see when accessing their files and directories on the iFolder server. The default is iFolder.
HTTPS is the default. This field should not be changed unless you want users' passphrases to be sent in clear text.
The DNS name and port number for the iFolder server. This setting shouldn't need to be changed unless you are changing the iFolder server you users will access. If you click the Set Defaults button the value will be set to whatever value appears in the Default Value column. If there is no value in the Default Value column the value will be set to blank (no value).
The port number that HTTPS is running on. This setting normally does not need to be changed. The default is 443.
This setting should not be changed except under direction from Novell.
Lets you view or edit the following configuration settings:
This text will be displayed on the NetStorage Web page and will be followed by the tree name and path to the user's home directory. The user might have home directories in multiple trees, in which case multiple paths will be displayed.
The default is Home@. You might want to change this if you want to reference home directories with a different word or in a language other than English. See the Alternate Tree Name bullet item below for more information on configuring NetStorage to display multiple home directories.
This text will be displayed on the NetStorage Web page and will include the drive letter being referenced followed by the path to the mapped drive. The user's login script on the primary tree is parsed by NetStorage to gather information on mapped drives. You might want to change this if you want to use a different word or words to reference mapped drives on the NetStorage Web page.
This setting should not be changed except under direction from Novell.
This registry key provides a way for any NetStorage user to make documents or files available to other NetStorage users. A public directory can be automatically created in each user's home directory by NetStorage. If public directories are created by NetStorage, all users in the same eDirectory context will have Read and File Scan rights to the other users' public directories. If you don't want public directories created in users' home directories, leave this field blank (the default). If you want public directories created in users' home directories enter the name for the public directories. For example, if you enter My Public Files as the name for the public directories, a folder named My Public Files will be created at the root of each user's home directory the first time the user logs in using NetStorage. To access a public directory, users need to add ~username at the end of the URL used to access NetStorage. For example if you want to access the public directory for a user named jsmith, you might enter a URL similar to http://file.i-login.net/oneNet/NetStorage/~jsmith.
When a user's home directory is displayed by NetStorage, the name of the eDirectory tree is also displayed. With this configuration field, you can substitute the tree name that users see in NetStorage to something that might be more intuitive. For example, if the tree name is SERVICES2 and you want users to see i-Login you would enter SERVICES2/i-Login in this configuration field. The eDirectory tree name and the substitute name are separated by a slash. NetStorage has the capability of accessing user home directories in multiple eDirectory trees. Multiple tree pairs can be listed with the pairs separated by a comma. If you want to substitute eDirectory tree names in more than one tree, separate the pairs by a comma and the tree name substitutions by a slash. An example of this is SERVICES2/i-Login,SERVEME2/Staging. The tree name is not case sensitive.
Specifies the number of container levels (from where the user object is located) that NetStorage will search up in the directory tree for the container login script. The default is 1, which is the same level used by Novell client software. If you specify a number greater than the number of container levels in the directory tree, NetStorage will search up to and including the root container in the tree. If you specify 0, NetStorage will only search the container where the user object is located.
Lets you view the location of the Home Directory, Mapped Drives, iFolder, and XFile stores. The value provides a more intuitive description than what is displayed in the Location column. The Value field should not be changed.
Configuration Settings on this page should not be changed except under direction from Novell.
Displays a report with information on the current NetStorage sessions. The report is in XML format and can be customized with a parser to provide specific information.
Displays the username and I/O Request information specific to your current NetStorage session.
Displays a detailed report of resource utilization (memory, etc.) for NetStorage. The report is in XML format and can be customized with a parser to provide specific information.
Displays a report with information on things like server up time, login failures, number of NetStorage sessions, etc. The report is in XML format and can be customized with a parser to provide specific information.
Lets you view or edit the protocol, IP address, and port number of your Web server. These settings do not normally need to be changed unless you change the IP address or port number of your Web server or you want to change to secure mode.
By default the servlet will make a request using the same IP address and port number that was used by the client making the servlet request. Tomcat uses non-secure mode by default. If you change the protocol to secure mode (https://), you must configure Tomcat for secure mode (SSL) and change the port number to a secure port. Changing to a secure protocol and port number will slow down network communication because all requests must be repeatedly encrypted and unencypted.
Servlets do not require SSL to be secure because servlet requests stay on the Web server and aren't sent over the wire. This eliminates the need and the overhead of SSL.