The following script helps create and manage profiles. Variants of this script are provided with
different extensions for different platforms (.bat for Windows and
.sh for UNIX). The operation is the same in each case.
Creating a profile
create_profile [options] <profile-name>
- Creates a new profile with the specified name. The profile name must be appropriate for use as a
directory name on the server host (because the script will create a directory with that name) and
should not contain spaces. The name must be distinct from any existing profile name.
-
- Options:
-d, --profiles-directory<profiles-directory>
- Specifies the profiles directory in which this and all subsequent profiles
should be created. You must specify this only for the first profile, but a good practice is to
specify it every time. If you omit it the first time, a default location will be chosen. If you
change the profiles directory on a subsequent call, the new profile will be
created in the new location, but any existing profiles will be ignored unless they are moved
separately to the new location.
-t, --template <profile-name>
- Specifies the name of an existing profile to use as a template. The profile configuration is
copied from the existing profile to the new profile, and only the port number is changed.
-p, --port-number <port-number>
- Specifies the port number for the profile service. The port number must be unique to this
profile. If you omit the port number, a default will be chosen.
-g, --group-name <group-name>
- Specifies the name of an operating system group that will have exclusive access to this profile.
The profile is configured to allow login access only to members of this group.
- File system permissions are not changed, so you must perform that action separately.
-
- Examples:
scripts\profiles\create_profile.bat -d C:\Modeler\Profiles comet
- Creates a new profile called
comet
in the directory
C:\Modeler\Profiles. The profile will listen on a default port number. To
determine the port number, open the options.cfg file that is generated for the
profile (in this example, C:\Modeler\Profiles\comet\config\options.cfg).
scripts\profiles\create_profile.bat --template comet --group-name "Meteor Users"
--port-number 28510 meteor
- Creates a new profile called
meteor
in the directory
C:\Modeler\Profiles (remembered from the previous command). The profile will
listen on port 28510 and login access will be allowed only to members of the group Meteor
Users
. All other configuration options will be copied from the existing profile
comet
.